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.