Skip to main content

Environment Variables

VariableDefaultDescription
ALCHEMIST_CONFIG_PATH~/.config/alchemist/config.tomlPath to config file
ALCHEMIST_CONFIG(alias)Alias for ALCHEMIST_CONFIG_PATH
ALCHEMIST_DB_PATH~/.config/alchemist/alchemist.dbPath to SQLite database
ALCHEMIST_DATA_DIR(none)Sets data dir; alchemist.db placed here
ALCHEMIST_CONFIG_MUTABLEtrueSet false to block runtime config writes
RUST_LOGinfoLog level: info, debug, alchemist=trace

Default paths: XDG on Linux/macOS, %APPDATA%\Alchemist\ on Windows.

Docker

Always set path variables explicitly to paths inside your mounted volumes. Without this, files are lost when the container is removed.

environment:
- ALCHEMIST_CONFIG_PATH=/app/config/config.toml
- ALCHEMIST_DB_PATH=/app/data/alchemist.db

Recommended host bind mount:

volumes:
- ~/.config/alchemist:/app/config
- ~/.config/alchemist:/app/data