Environment Variables

This page lists the environment variables used by the Docker deployment.

Domains

Variable	Example	Used by
`APP_DOMAIN`	`rocontrol.duckdns.org`	Caddy, backend
`API_DOMAIN`	`api-rocontrol.duckdns.org`	Caddy, frontend, backend
`DOCS_DOMAIN`	`docs.rocontrol.duckdns.org`	Caddy
`ACME_EMAIL`	`ops@example.com`	Caddy certificates

Database

Variable	Used by
`POSTGRES_DB`	Postgres and backend
`POSTGRES_USER`	Postgres and backend
`POSTGRES_PASSWORD`	Postgres and backend
`DATABASE_URL`	Backend container

Auth and app secrets

Variable	Purpose
`ROBLOX_CLIENT_ID`	Roblox OAuth app client ID
`ROBLOX_CLIENT_SECRET`	Roblox OAuth app client secret
`ROBLOX_REDIRECT_URI`	Roblox OAuth callback
`SESSION_SECRET`	Backend session signing
`APP_ENCRYPTION_KEY`	Backend encrypted secret storage

Frontend

Variable	Purpose
`NEXT_PUBLIC_ROCONTROL_BACKEND_URL`	Browser-visible backend API base URL
`ROCONTROL_INTERNAL_BACKEND_URL`	Container-internal backend base URL
`NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY`	Clerk publishable key if Clerk is enabled
`CLERK_SECRET_KEY`	Clerk server secret if Clerk is enabled

Icon Automation

Variable	Purpose
`ICON_AUTOMATION_STORAGE_DIR`	Where uploaded icon assets are stored
`ICON_AUTOMATION_INTERVAL_MS`	Scheduler interval

Discord and Roblox integration secrets may also be required depending on which Icon Automation features are enabled.