Skip to main content
Configure the Blink Server using CLI flags or environment variables.

Configuration Reference

Environment VariableCLI FlagDefaultDescription
BLINK_HOST-h, --host0.0.0.0Host to bind the server to
BLINK_PORT-p, --port3005Port to run the server on
BLINK_ACCESS_URL--access-url-Public access URL for the server
BLINK_AUTH_SECRET--auth-secret(auto-generated)Secret used for authentication
BLINK_POSTGRES_URL--postgres-url-PostgreSQL connection URL
BLINK_WILDCARD_ACCESS_URL--wildcard-access-url-Wildcard domain for subdomain routing. See Webhooks and Devhooks.
BLINK_AGENT_IMAGE--agent-imageghcr.io/coder/blink-agent:latestDocker image for agent containers

Configuration Priority

CLI flags take precedence over environment variables, which take precedence over default values.

Auto-Generated Secrets

If BLINK_AUTH_SECRET is not set, the server automatically generates and stores a secret in ~/.config/blink-server/auth-secret.txt. Set this explicitly in production.

PostgreSQL Connection

The BLINK_POSTGRES_URL should be a standard PostgreSQL connection string:
postgresql://user:password@host:5432/database
Migrations run automatically on server startup.