diff options
Diffstat (limited to 'player-server/docs/configuration.md')
| -rw-r--r-- | player-server/docs/configuration.md | 19 |
1 files changed, 19 insertions, 0 deletions
diff --git a/player-server/docs/configuration.md b/player-server/docs/configuration.md new file mode 100644 index 0000000..60d6ad6 --- /dev/null +++ b/player-server/docs/configuration.md @@ -0,0 +1,19 @@ +Configuration +============= + +All settings are environment variables. Unset variables use defaults. + +| Variable | Default | Validation | Description | +|----------|---------|------------|-------------| +| `PORT` | `8080` | 0–65535 | HTTP listen port (0 = ephemeral, used in tests) | +| `MEDIA_ROOT` | `./media` | — | Root path for media set directories | +| `DB_PATH` | `data.db` | — | SQLite database file path | +| `MAX_UPLOAD_SIZE_MB` | `100` | ≥ 1 | Max upload size per file (MB) | +| `SESSION_TIMEOUT_HOURS` | `24` | ≥ 1 | Cookie / session expiry | +| `GC_INTERVAL_MINUTES` | `30` | ≥ 1 | Garbage collector tick interval | +| `SHARE_DEFAULT_EXPIRY_DAYS` | `7` | ≥ 1 | Default share link lifetime | +| `PODCAST_CHECK_INTERVAL_MINUTES` | `60` | ≥ 1 | Podcast feed refresh interval | +| `LOG_LEVEL` | `info` | `debug` / `info` / `warn` / `error` | Log verbosity | +| `SECURE_COOKIES` | `true` | `true` / `false` | Set `Secure` flag on session cookies; set to `false` for plain-HTTP local deployments | + +**Important:** The K8s `Deployment` overrides `DB_PATH` to `/data/media.db` and `MEDIA_ROOT` to `/media` so the PVC mounts are used. Do not rely on the local defaults in a container.
\ No newline at end of file |