Platforms

Render

Run a single control plane instance on Render with a persistent disk.

Render runs one control plane instance with a Render persistent disk. Use it to try Rivet on a managed platform. For production, run three or more instances on Kubernetes or VMs.

Requirements

A Render account
An object storage bucket, such as S3.

Steps

Create the service

Create a Web Service from the image rivetdev/engine:2.3.31 with the Docker command --config /etc/rivet.

Add a disk

Add a persistent disk mounted at /var/lib/rivet/log. A service with a disk runs one instance.

Set the variables

RIVET__AUTH__ADMIN_TOKEN=<openssl rand -hex 32>
RIVET__DEPOT__LOG_DIRECTORY=/var/lib/rivet/log
RIVET__DEPOT__AUTO_PROVISION_TABLETS=1
RIVET__DEPOT__BALANCING__ENABLED=false
RIVET__OBJECT_STORAGE__PRIMARY__S3__BUCKET=my-rivet-bucket
RIVET__OBJECT_STORAGE__PRIMARY__S3__REGION=us-east-1
RIVET__OBJECT_STORAGE__PRIMARY__S3__ACCESS_KEY_ID=...
RIVET__OBJECT_STORAGE__PRIMARY__S3__SECRET_ACCESS_KEY=...

See Storage for other object storage backends.

Expose port 6420 and verify

Set the service port to 6420, then:

curl https://<service>.onrender.com/health

{"runtime":"engine","status":"ok","version":"2.3.31",...}