Getting started
Configuration
The two config surfaces and the values you need to set first.
llama-dash has two configuration surfaces:
.env— llama-dash's own settings (backend URL, database, auth secrets, timeouts). Loaded at startup.config.yaml— the llama-swap config (your models and peers). llama-dash reads and, with the config editor enabled, writes this file. See the config file reference, or start from its example upstream config.
Values to set first
Copy .env.example to .env and set at least these:
| Variable | Why |
|---|---|
INFERENCE_BASE_URL | Where your llama-swap instance is reachable (no trailing slash). If running the default docker setup, leave the value from the .env.example. |
INFERENCE_CONFIG_FILE | Absolute path to config.yaml — required for the in-dashboard config editor. When running the default docker setup, leave this one as set in .env.example as well |
BETTER_AUTH_SECRET | Signs dashboard sessions. Generate with openssl rand -base64 33. |
CREDENTIAL_ENCRYPTION_KEY | 32+ characters. Required before storing any upstream provider credentials. |
CREDENTIAL_ENCRYPTION_KEY must be set before you create or use stored upstream
credentials (direct upstreams and MCP relays). Without it, credential features
are unavailable.
The complete list — with defaults and notes — lives in the environment variables reference.
Last updated on