Configuration

Environment variables

Variable	Required	Description	Default	Example
`APP_PORT`	No	Port to expose on host	`4321`	`8080`
`PUID`	No	User ID for file permissions (Linux)	`1000`	`1000`
`PGID`	No	Group ID for file permissions (Linux)	`1000`	`1000`
`TZ`	No	Timezone for notification schedules	`UTC`	`Europe/Amsterdam`
`POSTGRES_USER`	Yes	PostgreSQL username	`vitransfer`	`vitransfer`
`POSTGRES_PASSWORD`	Yes	PostgreSQL password (hex only)	-	Generated with `openssl rand -hex 32`
`POSTGRES_DB`	Yes	PostgreSQL database name	`vitransfer`	`vitransfer`
`REDIS_PASSWORD`	Yes	Redis password (hex only)	-	Generated with `openssl rand -hex 32`
`ENCRYPTION_KEY`	Yes	Data encryption key (base64)	-	Generated with `openssl rand -base64 32`
`JWT_SECRET`	Yes	JWT signing secret (base64)	-	Generated with `openssl rand -base64 64`
`JWT_REFRESH_SECRET`	Yes	JWT refresh secret (base64)	-	Generated with `openssl rand -base64 64`
`ADMIN_EMAIL`	Yes	Initial admin email	-	`admin@example.com`
`ADMIN_PASSWORD`	Yes	Initial admin password	-	`Admin1234`
`ADMIN_NAME`	No	Initial admin display name	`Admin`	`Jane Doe`
`SHARE_TOKEN_SECRET`	Yes	Secret for signing share tokens	none
`HTTPS_ENABLED`	No	Enable HTTPS enforcement (HSTS)	`true`	`false` for localhost
`NEXT_PUBLIC_TUS_ENDPOINT`	No	If TUS is on another origin, add it to connect-src	none
`CPU_THREADS`	No	Override CPU thread count used by the worker/FFmpeg	auto-detect	`8`
`DEBUG_WORKER`	No	Enable verbose worker logging	`false`	`true`
`DEBUG_EXTERNAL_NOTIFICATIONS`	No	Enable verbose external notification logging	`false`	`true`