Server variables: database, keys, metrics, agents, webhook, and what happens when they are unset.
Status: availableupdated 2026-11-06
Main
Variable
What it sets
Without it
DATABASE_URL
Postgres with rooms, IAM and the journal; connection as the application role remo_app
the service refuses to start if a database is set but unreachable; without the variable disk mode works
REMO_MIGRATION_DATABASE_URL
Postgres for schema and maintenance: migrations, db:check, db:orphans, db:rls; connection as the owner role
the service uses DATABASE_URL for schema too; RLS needs two roles
PORT
port of the sync service
1234
REMO_DATA_DIR
directory for disk mode
apps/sync/.data
The service connects as remo_app: DML only, no table ownership and no BYPASSRLS. Schema and maintenance use the owner role through REMO_MIGRATION_DATABASE_URL; the owner must be a superuser or have BYPASSRLS.
Example
# /srv/remo/.env, mode 600, owned by the service user
DATABASE_URL=postgres://remo_app:<app password>@127.0.0.1:5432/remo
REMO_MIGRATION_DATABASE_URL=postgres://remo:<owner password>@127.0.0.1:5432/remo
NODE_ENV=production
PORT=1234
REMO_APP_ORIGIN=https://boards.example.com
REMO_CORS_ORIGIN=https://boards.example.com
REMO_METRICS_TOKEN=<32 random bytes>
REMO_DATA_DIR=/var/lib/remo
REMO_KEK=<openssl rand -base64 32>
REMO_KEK_ID=v1
Security and keys
Variable
What it sets
REMO_KEK
wrapping key for secrets: 32 bytes in base64
REMO_KEK_ID
key version, v1 by default
REMO_APP_ORIGIN
application address for links in emails and invitations
REMO_CORS_ORIGIN
allowed origin for the API; * by default
Without REMO_KEK a provider key cannot be added and a webhook cannot be set up: the server answers WEBHOOK_LOCKED or AI_CREDENTIALS_LOCKED. Secrets already stored are not decrypted if the key is lost.