Skip to content

Server settings

Environment of the app server; the deployed server refuses to start without the first five.

Setting Meaning
VIRTUFIN_APP_OIDC_ISSUER The OIDC provider.
VIRTUFIN_APP_OIDC_CLIENT_ID, VIRTUFIN_APP_OIDC_CLIENT_SECRET Its client (redirect <public URL>/auth/callback, scopes openid profile email groups).
VIRTUFIN_APP_PUBLIC_URL Where users reach the app (the callback, the Origin check).
VIRTUFIN_APP_SESSION_KEY Encrypts the cookies and derives the AI key seal (32+ characters). Rotating it signs everyone out and makes saved AI keys unreadable.
VIRTUFIN_APP_ADMIN_GROUP The provider group of admins (default virtufin-admins).
VIRTUFIN_APP_SESSION_HOURS How long a sign-in lasts (default 12).
VIRTUFIN_CONTEXTS_FILE, VIRTUFIN_CONTEXT The catalog (default ~/.config/virtufin/api/contexts.toml) and the default context.
VIRTUFIN_API_KEY The api key for contexts without their own api_key.
VIRTUFIN_APP_AI_BASE_URL, VIRTUFIN_APP_AI_MODEL, VIRTUFIN_APP_AI_API_KEY The optional org AI provider (all three).
VIRTUFIN_APP_LLM_PRICES_URL Where the LLM price list is loaded from (default LiteLLM's model_prices_and_context_window.json on GitHub; kept a day).
VIRTUFIN_APP_AI_DOCS_SITES The docs sites the assistant reads (comma-separated base URLs; default every Virtufin docs site, reloaded daily).
VIRTUFIN_APP_STATIC_DIR, PORT The built app's directory (default ./dist) and the port (default 3000).

The dev server (npm run dev) signs no one in unless the provider settings are set; then everyone is an admin. The image is published by CI only (.github/workflows/app-image.yaml) when versions.env changes; the deployment is the k3s-common role virtufin_app.