Vigie
Self-hosting

Configuration

Every environment variable Vigie reads, with its default.

On a server, set these in deploy/.env and run deploy/install.sh again: every variable there reaches Vigie. On your machine, set them in the shell that runs bunx vigie.

Core

VariableDefaultWhat it does
VIGIE_MODElocalserver turns on sign-in, keys and monitors. The Docker image sets it.
VIGIE_PUBLIC_URLhttp://localhost:4310The address people and apps use. Links in alerts point here.
VIGIE_DEFINITIONS./definitionsThe folder of your definitions.
VIGIE_ENVSDEV locally, PRD,STG on a serverEnvironments this Vigie keeps. Anything else lands in the last one, never in production.
VIGIE_DATA_DIR~/.vigie, /data on a serverWhere SQLite state and the spool live.
VIGIE_UI_PORT, VIGIE_INGEST_PORT4310, 4318The app and OTLP ports.
CLICKHOUSE_URL, CLICKHOUSE_USER, CLICKHOUSE_PASSWORD, CLICKHOUSE_DATABASEhttp://127.0.0.1:8123, default, empty, vigieWhere telemetry is stored.
VIGIE_TASK_METRICSvigie.tasksPrefix of the two task gauges.

Your app

VariableWhat it does
VIGIE_APP_NAMEYour app's name, as shown in buttons and messages.
VIGIE_APP_URLYour app's address, for "open in app" links.
VIGIE_APP_API_URLYour app's API. Task actions (requeue, cancel, run now) call it as the signed-in person.
VIGIE_APP_DATABASE_URLA read-only Postgres role (see deploy/app-readonly.sql), for the Database screen and queued tasks. Vigie refuses raw SQL if the role can read credentials.
VIGIE_SOURCE_REPO, VIGIE_GITHUB_TOKENowner/repo, to show the source behind stack frames.

Notifications

VariableWhat it does
VIGIE_SLACK_WEBHOOKA Slack channel, without going through Settings.
VIGIE_SMTP_URL, VIGIE_MAIL_FROMEmail alerts.
VIGIE_ALERT_GROUP_MSAlerts within this window go out as one message. 30 s by default.
VIGIE_LINEAR_API_KEY, VIGIE_LINEAR_TEAM_IDCreate Linear issue on issues.

Sign-in

VariableWhat it does
BETTER_AUTH_SECRETSigns sessions. deploy/install.sh generates it.
VIGIE_OIDC_ISSUER, VIGIE_OIDC_CLIENT_ID, VIGIE_OIDC_CLIENT_SECRET, VIGIE_OIDC_NAMESingle sign-on with any OpenID Connect provider.
VIGIE_ALLOW_SIGNUPtrue lets anyone with the address create an account. Off by default.

AI

VariableWhat it does
VIGIE_AI_API_KEYTurns on Ask Vigie, explain and search in words.
VIGIE_AI_BASE_URLAny OpenAI-compatible provider.
VIGIE_AI_MODELgpt-4.1-mini by default.
Copyright © 2026