Skip to main content
When running blink-server locally, it connects to a tunnel service to get a public URL. This lets external services like Slack and GitHub reach your local server. This feature exists to make it easy to try Blink without any setup. For production deployments, disable the tunnel and configure your own public URL.

How It Works

  1. Server generates a persistent secret (stored in ~/.config/blink-server/tunnel-secret.txt on Linux, path may differ on other OSes)
  2. Connects to the tunnel service with this secret
  3. Receives a public URL that proxies requests to your local server
  4. The same secret gives you the same URL across restarts

Configuration

OptionEnvironment VariableDefaultDescription
--tunnel-server-urlBLINK_TUNNEL_SERVER_URLhttps://try.blink.hostTunnel service URL
--access-urlBLINK_ACCESS_URL-Skip tunnel, use this URL directly

Production

In production, disable the tunnel and provide your own public URL:
blink-server --access-url https://blink.example.com