Skip to content

Environment Variables

All settings can be configured via environment variables. These take precedence over values in config.toml.

The image runs as root unless you set a user. To run as your own user, pass --user 1000:1000 to docker run or set user: "1000:1000" in Compose. Directories you bind-mount to /config must be writable by that user.

VariableDescriptionDefault
CLAUDIO_PORTHTTP port8080
CLAUDIO_CONFIG_PATHPath to the TOML config file/config/config.toml
CLAUDIO_LOG_LEVELLog level (error, warn, info, debug, trace)warn
VariableDescriptionDefault
CLAUDIO_LIBRARY_PATHSComma-separated game library paths/games
CLAUDIO_EXCLUDE_PLATFORMSComma-separated platform folders to skip
CLAUDIO_SCAN_INTERVALLibrary scan interval in seconds120
VariableDescriptionDefault
CLAUDIO_DB_PROVIDERsqlite or postgressqlite
CLAUDIO_DB_SQLITE_PATHSQLite database file path/config/claudio.db
CLAUDIO_DB_POSTGRESPostgreSQL connection string
VariableDescriptionDefault
CLAUDIO_IGDB_CLIENT_IDIGDB/Twitch client ID
CLAUDIO_IGDB_CLIENT_SECRETIGDB/Twitch client secret
CLAUDIO_IGDB_TIMEOUT_SECSMax runtime of a queued IGDB scan job600
CLAUDIO_STEAMGRIDDB_API_KEYSteamGridDB API key (for cover art search)
CLAUDIO_STEAMGRIDDB_TIMEOUT_SECSMax runtime of a queued SteamGridDB job900