Start
Environment Variables
Reference for supported variables at startup.
| Variable | Default Value | Usage |
|---|---|---|
PORT | 2498 in development | API port; the Docker image sets it to 2499 |
NODE_ENV | current environment | enables production behavior |
DATA_DIR | ./data | base, secret, cookies, and resources |
DOWNLOADS_DIR | ./downloads | videos and associated files |
YT_DLP_PATH | automatic detection | explicit path to yt-dlp |
AUTH_PASSWORD | empty | initial password for the instance |
SESSION_SECRET | generated locally | session signing, minimum 16 characters |
VIDARCH_BIND_ADDRESS | 127.0.0.1 in Compose | listening address published by Docker |
Use a secrets manager or a non-versioned .env file. Never place a real secret value in compose.yml or in the Git repository.