diff options
| author | Paul Buetow <paul@buetow.org> | 2026-05-05 21:26:46 +0300 |
|---|---|---|
| committer | Paul Buetow <paul@buetow.org> | 2026-05-05 21:26:46 +0300 |
| commit | 83ffe8544aa7845810049083d1376f7c7d01cd2c (patch) | |
| tree | 12010312175f9fca91c9115ca865bb0fb50fd63c /docs/configuration.md | |
| parent | 7bc3b65b3c66c7744e1c6d4fa69842985d06d9b7 (diff) | |
Expand README and split documentation into docs/ directory
Diffstat (limited to 'docs/configuration.md')
| -rw-r--r-- | docs/configuration.md | 19 |
1 files changed, 19 insertions, 0 deletions
diff --git a/docs/configuration.md b/docs/configuration.md new file mode 100644 index 0000000..60d6ad6 --- /dev/null +++ b/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 |