Config File

As an alternative to environment variables, Claudio can be configured with a TOML file. The config path is set via the CLAUDIO_CONFIG_PATH environment variable, defaulting to /config/config.toml.

Environment variables take precedence over config file values.

Example

[server]
port = 8080

[database]
provider = "sqlite"             # "sqlite" or "postgres"
sqlite_path = "/config/claudio.db"
# postgres_connection = "Host=localhost;Database=claudio;Username=claudio;Password=secret"

[auth]
jwt_secret = "CHANGE-ME-TO-A-RANDOM-SECRET"
access_token_expiry_minutes = 15       # Short-lived access token
refresh_token_expiry_days = 180        # Long-lived refresh token (6 months). Use -1 for infinite expiry
# proxy_auth_header = "Remote-User"
# proxy_auth_auto_create = false

[igdb]
client_id = ""
client_secret = ""

[library]
library_paths = ["/games"]

Sections

[server]

Server configuration including the HTTP port.

[database]

Database provider selection (sqlite or postgres) and connection details.

[auth]

Authentication settings including JWT secrets, token expiry, and proxy authentication. See Authentication for details.

[igdb]

IGDB/Twitch API credentials for game metadata. See the Twitch Developer Portal to create credentials.

[library]

List of paths to scan for game directories.

[auth.github] / [auth.google]

OAuth provider credentials. See OAuth Providers.

[auth.oidc_provider]

Custom OpenID Connect provider. See Custom OIDC.