Skip to main content
The default instance writes installation settings to ~/.podium/config.json. An instance selected with PODIUM_INSTANCE uses ${XDG_STATE_HOME:-$HOME/.local/state}/podium/instance_name/config.json. Environment variables override matching file values, which override built-in defaults.

Configuration locations

The state root keeps configuration beside the database and runtime files: Set PODIUM_STATE_DIR to move the whole state root. Do not point two live instances at the same directory.

Supported operator keys

These file keys are useful for local and self-hosted operation: Use podium setup and podium channel for routine changes. Hand-edit the file only when no supported command covers the setting, then restart for boot-time values such as mode, port, and bind host.

Common environment overrides

Use environment overrides when the deployment, rather than the interactive setup flow, owns a value: For layered values that appear in setup, an environment-owned value locks the corresponding control. Change the deployment environment instead of editing the file.
Many additional PODIUM_* variables exist for internal services, tests, or hosted deployment. The entries above are supported operator controls, not an inventory of every source-level variable. Do not treat an unlisted variable as a public contract unless it also appears in command help or deployment documentation.
Last modified on September 16, 2026