Skip to content

Environment variables ​

Defaults are loaded first, persisted settings second, and runtime environment overrides last. Runtime overrides are effective without rewriting /data/state/settings.json.

User-facing overrides ​

VariableDefaultEffect
DB_AUTO_UPDATEtrueOverrides automatic-update enabled state
DB_UPDATE_INTERVAL86400Overrides interval in seconds; valid range 60–604800
DB_UPDATE_START_DELAY60Delay before the first periodic check
ICVDB_RESULT_PRESETunfilteredOverrides the active preset
ICVDB_PROWLARR_URLemptyOverrides the Prowlarr base URL
ICVDB_PROWLARR_API_KEYemptyOverrides the Prowlarr API key
PROWLARR_API_KEYemptyCompatibility API-key override; wins when both key variables are set
PROWLARR_INDEXER_URLemptyOverrides the Torznab URL given to Prowlarr
SNAPSHOT_LATEST_URLGitHub latest-release APIChanges the snapshot release metadata source
SNAPSHOT_STATE_FILE/data/state/snapshot-versionChanges the installed-version state path
ICVDB_SETTINGS_PATH/data/state/settings.jsonChanges the settings path

Internal runtime variables ​

The image supplies these values for its embedded PostgreSQL instance. Normal single-container deployments should not change them.

VariableImage value
DB_HOST127.0.0.1
DB_PORT5432
DB_NAMEicv_db
DB_USERicv
DB_PASSWORDinternal container value
DB_ADMIN_DBpostgres when unset
FRONTEND_DIST_DIR/app/frontend-dist when unset

Secrets

Use container secrets or protected deployment configuration for API keys. The application masks keys in normal read responses, but it does not encrypt values stored in settings.json.

Violarr was created and made possible in part through generative AI tools, under human direction and review.