Skip to content

Environment variables

Kanade reads environment variables at daemon or desktop-supervisor startup. Prefer the Settings UI for normal workstation configuration; use env vars for automation, private deploys, and diagnostics.

VariablePurpose
KANADE_HOST / KANADE_PORTDaemon bind address and port. Installed desktop uses loopback and a sticky 8200-range port.
KANADE_HOMEAlternate home root for Claude/Kanade paths.
KANADE_DATA_DIRBase data directory. Derives database, accounts, transcripts, and memory paths when specific vars are unset.
KANADE_SPOOLHook JSONL spool path.
KANADE_DBSQLite chronicle path.
KANADE_SKILLS_DIRSkill catalog root.
KANADE_MEMORY_DIRKanade-owned markdown memory storage.
KANADE_MEMORY_ROOTSComma-separated markdown roots to index.
KANADE_DEFAULT_MEMORY_ROOTSOnboarding defaults for memory roots.
KANADE_DISABLE_DEFAULT_MEMORY_ROOTSSet to 1 to disable default root guesses.
KANADE_VAULT_ROOTSLocal reveal allowlist for private vault paths.
KANADE_BUG_REPORT_URLOptional issue-tracker URL surfaced in About/Settings.
KANADE_GITHUB_ORG_ALLOWLISTSafe GitHub org names for issue/repo handoff links.
KANADE_UPDATE_CHANNEL_URLOverride signed Tauri updater manifest URL.
KANADE_WEB_BUILDStatic web build directory for an unbundled daemon.
KANADE_VERSION_OVERRIDE / KANADE_GIT_SHADiagnostic version overrides.
KANADE_LM_URL / KANADE_LM_MODELLM Studio/OpenAI-compatible voice endpoint.
KANADE_OLLAMA_URL / KANADE_OLLAMA_MODELOllama-compatible voice endpoint.
KANADE_VOICE_BACKENDlmstudio or ollama.
KANADE_LM_TIMEOUT_SVoice endpoint timeout.
KANADE_DREAM_CRON / KANADE_DREAM_QUIET_MINUTESDream Review schedule and idle window.
KANADE_FORGE_BACKEND_URL / KANADE_FORGE_BACKEND_AUTHForge bridge backend and server-side auth.
KANADE_FORGE_PROJECTForge project slug used by mission bridge requests.
KANADE_DISCORD_BRIDGE_SECRETHMAC secret for signed Discord ingress.
KANADE_ALLOWED_REMOTE_ADDRSRemote address allowlist for non-loopback daemon requests.
KANADE_SEND_TURN_TIMEOUT_SProvider turn timeout.
KANADE_SSE_BATCH_MSDaemon SSE delta batching interval.
KANADE_STDERR_BUFFER_BYTESPer-lane stderr buffer cap.
KANADE_LIVE_USAGE_MAX_ACCOUNTSLive usage/account status cap.
KANADE_PASTE_RETENTION_DAYS / KANADE_PASTE_MAX_BYTESPasted artifact retention and size guard.
KANADE_SHUTDOWN_TOKENDesktop supervisor one-shot daemon shutdown secret.

Secrets belong in the environment, a local config file, or a secret manager, not in public docs, git, screenshots, or issue reports.