Render Deployment

Create the Blueprint Files

Add these three files to the root of your GitHub repository:

render.yaml

databases:
  - name: rivet-db
    plan: basic-256mb
    databaseName: rivet
    user: rivet

services:
  - type: web
    name: rivet-engine
    runtime: docker
    dockerfilePath: ./Dockerfile.render
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: DATABASE_URL
        fromDatabase:
          name: rivet-db
          property: connectionString
      - key: RIVET__AUTH__ADMIN_TOKEN
        generateValue: true

Dockerfile.render

FROM rivetdev/engine:latest

COPY entrypoint.render.sh /entrypoint.render.sh
RUN chmod +x /entrypoint.render.sh

ENTRYPOINT ["/entrypoint.render.sh"]

entrypoint.render.sh

#!/bin/sh

if [ -n "$DATABASE_URL" ]; then
    export RIVET__POSTGRES__URL="${DATABASE_URL}?sslmode=disable"
fi

exec /usr/bin/rivet-engine start

Commit and push these files to your repository.

Deploy to Render

1. Go to the Render Dashboard
2. Click Blueprints in the left sidebar
3. Click New Blueprint Instance
4. Connect your GitHub account if you haven’t already
5. Select the repository containing the files from the previous step
6. Click Apply

Render will automatically create the PostgreSQL database and deploy the Rivet Engine.

Get Your Admin Token

1. Once deployed, go to your rivet-engine service in the Render Dashboard
2. Click the Environment tab
3. Find RIVET__AUTH__ADMIN_TOKEN and click the eye icon to reveal the value
4. Copy this token — you’ll need it to access the dashboard

Access the Rivet Dashboard

Open your service URL in a browser:

https://rivet-engine-xxxx.onrender.com/ui/

Replace rivet-engine-xxxx with your actual service name from the Render Dashboard.

Enter the admin token from the previous step to log in.