Environment Variables Reference

Complete reference of all environment variables supported by Mydia.

Required Variables

Variable	Description	Example
`SECRET_KEY_BASE`	Phoenix secret key for cookies/sessions	Generate with: `openssl rand -base64 48`
`GUARDIAN_SECRET_KEY`	JWT signing key for authentication	Generate with: `openssl rand -base64 48`

Variable	Description	Default
`PUID`	User ID for file permissions	`1000`
`PGID`	Group ID for file permissions	`1000`
`TZ`	Timezone (e.g., `America/New_York`)	`UTC`
`DATABASE_PATH`	Path to SQLite database file	`/config/mydia.db`

Variable	Description	Default
`PHX_HOST`	Public hostname for the application	`localhost`
`PORT`	Web server port	`4000`
`HOST`	Server binding address	`0.0.0.0`
`URL_SCHEME`	URL scheme for external links	`http`
`PHX_CHECK_ORIGIN`	WebSocket origin checking	Allows `PHX_HOST` with any scheme

Configure additional libraries using numbered variables (<N> = 1, 2, 3, etc.):

Variable Pattern	Description	Example
`LIBRARY_PATH_<N>_PATH`	Directory path	`/media/music`
`LIBRARY_PATH_<N>_TYPE`	Library type	`music`
`LIBRARY_PATH_<N>_MONITORED`	Enable monitoring	`true`
`LIBRARY_PATH_<N>_SCAN_INTERVAL`	Scan interval in seconds	`3600`
`LIBRARY_PATH_<N>_QUALITY_PROFILE_ID`	Quality profile ID	`1`

Library Types: movies, series, mixed, music, books, adult

Variable	Description	Default
`LOCAL_AUTH_ENABLED`	Enable local username/password auth	`true`
`OIDC_ENABLED`	Enable OIDC/OpenID Connect auth	`false`
`OIDC_DISCOVERY_DOCUMENT_URI`	OIDC discovery endpoint URL	-
`OIDC_CLIENT_ID`	OIDC client ID	-
`OIDC_CLIENT_SECRET`	OIDC client secret	-
`OIDC_REDIRECT_URI`	OIDC callback URL	Auto-computed
`OIDC_SCOPES`	Space-separated scope list	`openid profile email`

Variable	Description	Default
`ENABLE_PLAYBACK`	Enable media playback controls and HLS streaming	`true`
`ENABLE_CARDIGANN`	Enable native Cardigann indexer support	`true`
`ENABLE_SUBTITLES`	Enable subtitle download and management	`false`
`ENABLE_IMPORT_LISTS`	Enable import lists for syncing external lists (TMDB watchlists, popular, etc.)	`true`

Configure multiple clients using numbered variables (<N> = 1, 2, 3, etc.):

Variable Pattern	Description	Example
`DOWNLOAD_CLIENT_<N>_NAME`	Display name	`qBittorrent`
`DOWNLOAD_CLIENT_<N>_TYPE`	Client type	`qbittorrent`
`DOWNLOAD_CLIENT_<N>_ENABLED`	Enable this client	`true`
`DOWNLOAD_CLIENT_<N>_PRIORITY`	Client priority (higher = preferred)	`1`
`DOWNLOAD_CLIENT_<N>_HOST`	Hostname or IP	`qbittorrent`
`DOWNLOAD_CLIENT_<N>_PORT`	Client port	`8080`
`DOWNLOAD_CLIENT_<N>_USE_SSL`	Use SSL/TLS	`false`
`DOWNLOAD_CLIENT_<N>_USERNAME`	Auth username	-
`DOWNLOAD_CLIENT_<N>_PASSWORD`	Auth password	-
`DOWNLOAD_CLIENT_<N>_API_KEY`	API key (SABnzbd)	-
`DOWNLOAD_CLIENT_<N>_CATEGORY`	Default category	-
`DOWNLOAD_CLIENT_<N>_DOWNLOAD_DIRECTORY`	Download directory	-

Client Types: qbittorrent, transmission, sabnzbd, nzbget

Configure multiple indexers using numbered variables (<N> = 1, 2, 3, etc.):

Variable Pattern	Description	Example
`INDEXER_<N>_NAME`	Display name	`Prowlarr`
`INDEXER_<N>_TYPE`	Indexer type	`prowlarr`
`INDEXER_<N>_ENABLED`	Enable this indexer	`true`
`INDEXER_<N>_PRIORITY`	Search priority (higher = preferred)	`1`
`INDEXER_<N>_BASE_URL`	Indexer base URL	`http://prowlarr:9696`
`INDEXER_<N>_API_KEY`	Indexer API key	-
`INDEXER_<N>_INDEXER_IDS`	Comma-separated indexer IDs	`1,2,3`
`INDEXER_<N>_CATEGORIES`	Comma-separated categories	`movies,tv`
`INDEXER_<N>_RATE_LIMIT`	Rate limit (requests/sec)	-

Indexer Types: prowlarr, jackett, public

For PostgreSQL deployments (using latest-pg image):

Variable	Description	Default
`LOG_LEVEL`	Log level (debug, info, warning, error)	`info`
`SKIP_BACKUPS`	Disable automatic database backups	`false`

Configuration is loaded in this order (highest to lowest priority):