Server Options

Configure the Blink Server using CLI flags or environment variables.

Configuration Reference

Environment Variable	CLI Flag	Default	Description
`BLINK_HOST`	`-h, --host`	`0.0.0.0`	Host to bind the server to
`BLINK_PORT`	`-p, --port`	`3005`	Port 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-image`	`ghcr.io/coder/blink-agent:latest`	Docker 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.

Get Started

Server

Blink Essentials

Agent Use Cases

Configuration Reference

Configuration Priority

Auto-Generated Secrets

PostgreSQL Connection

​Configuration Reference

​Configuration Priority

​Auto-Generated Secrets

​PostgreSQL Connection

Configuration Reference

Configuration Priority

Auto-Generated Secrets

PostgreSQL Connection