> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blink.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Server Options

> Configuration options for the Blink Server.

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](/docs/server/webhooks). |
| `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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.