Skip to content

Deployment configuration

Compose loads .env. Restart the container after changing environment values.

Variable Purpose
TZ Container timezone
DATABASE_PATH SQLite database path
VODUM_LOG_DIR Persistent log directory
VODUM_BACKUP_DIR Persistent backup directory
VODUM_IMPORTS_DIR Optional import/restore directory override
VODUM_ENCRYPTION_KEY_FILE Persistent encryption-key path
VODUM_PORT Waitress listening port
VODUM_WAITRESS_THREADS Waitress worker threads
VODUM_DEBUG Debug mode (0 or 1)
VODUM_MAX_UPLOAD_MB Maximum complete request size
VODUM_MAX_ZIP_EXTRACTED_MB Maximum restored ZIP size after extraction
VODUM_MAX_ZIP_MEMBERS Maximum ZIP entry count
VODUM_TRUST_PROXY Enable trusted forwarded headers
VODUM_TRUSTED_PROXY_NETS CIDRs allowed to supply forwarded headers
VODUM_ALLOWED_NETS CIDRs allowed by the application IP filter

VODUM_IMPORTS_DIR defaults to an imports directory beside DATABASE_PATH. If the database location changes, ensure its parent and all configured data directories are persistent and writable.

Additional security overrides include VODUM_SECRET_KEY, VODUM_ENCRYPTION_KEY, cookie settings and authentication rate-limit values. Prefer persistent generated keys over inline secrets when possible.