Render
The repository has a Render Blueprint (deploy/render.yaml) that creates the collector as a Docker web service and a
Render PostgreSQL 17 database, wires DATABASE_URL, and generates the session secret and settings key.
-
Create the Blueprint
In Render, choose New → Blueprint, connect your fork of Shardlens and set Blueprint path to
deploy/render.yaml. Render shows theshardlensservice and theshardlens-dbdatabase. -
Fill in the variables Render asks for
Variable Value SHARDLENS_PUBLIC_URLYour service URL, for example https://shardlens.onrender.comSHARDLENS_APP_IDYour Discord application ID SHARDLENS_INGEST_KEYnpx shardlens keys --scope ingestSHARDLENS_READ_KEYnpx shardlens keys --scope readThe service URL is
https://followed by the service name and.onrender.com, but Render adds a few characters when that name is taken. After the first deploy, compare it with the URL at the top of the service’s page and, if they differ, correctSHARDLENS_PUBLIC_URLunder Environment: Discord sign-in and the links in alerts and reports use it.Leave
DISCORD_CLIENT_ID,DISCORD_CLIENT_SECRETandDISCORD_PUBLIC_KEYempty unless you want Discord sign-in or webhook events.SHARDLENS_SESSION_SECRETandSHARDLENS_SETTINGS_KEYare generated for you; copy the settings key somewhere safe, because encrypted settings can’t be read without it. -
Apply. Render builds the image, the collector applies its migrations, and the health check on
/readyzturns green.