feat: add VitePress docs site, music file picker modal, Dockerfile optimization, i18n keys for 14 locales

- Add docs/ with VitePress site (19 pages): guide, config, architecture, FAQ - Add GitHub Actions workflow for auto-deploy to GitHub Pages - Replace music 'Add Tracks' upload picker with in-app audio file browser modal - Add music picker CSS styles with dark theme support - Add missing i18n keys (search_audio, no_audio_files, etc.) to all 14 locales - Optimize Dockerfile: shared base stage, COPY --chmod, consolidated RUN, HEALTHCHECK - Improve README: docs links, updated stats (222+ tests, 14 languages), feature status
2026-04-11 20:58:34 +02:00
parent 1bb65e6448
commit f08cffc0e8
42 changed files with 4313 additions and 95 deletions
@@ -0,0 +1,83 @@
+# Environment Variables
+
+All variables use the `OXICLOUD_` prefix.
+
+## Server
+
+| Variable | Default | Description |
+|---|---|---|
+| `OXICLOUD_STORAGE_PATH` | `./storage` | Root storage directory |
+| `OXICLOUD_STATIC_PATH` | `./static` | Static files directory |
+| `OXICLOUD_SERVER_PORT` | `8086` | Server port |
+| `OXICLOUD_SERVER_HOST` | `127.0.0.1` | Server bind address |
+| `OXICLOUD_BASE_URL` | (auto) | Public base URL for share links |
+
+## Database
+
+| Variable | Default | Description |
+|---|---|---|
+| `OXICLOUD_DB_CONNECTION_STRING` | `postgres://postgres:postgres@localhost:5432/oxicloud` | PostgreSQL connection string |
+| `OXICLOUD_DB_MAX_CONNECTIONS` | `20` | Max pool connections |
+| `OXICLOUD_DB_MIN_CONNECTIONS` | `5` | Min pool connections |
+
+## Authentication
+
+| Variable | Default | Description |
+|---|---|---|
+| `OXICLOUD_JWT_SECRET` | (random) | JWT signing secret |
+| `OXICLOUD_ACCESS_TOKEN_EXPIRY_SECS` | `3600` | Access token lifetime (seconds) |
+| `OXICLOUD_REFRESH_TOKEN_EXPIRY_SECS` | `2592000` | Refresh token lifetime (seconds) |
+
+## Feature Flags
+
+| Variable | Default | Description |
+|---|---|---|
+| `OXICLOUD_ENABLE_AUTH` | `true` | Enable authentication |
+| `OXICLOUD_ENABLE_USER_STORAGE_QUOTAS` | `false` | Per-user storage quotas |
+| `OXICLOUD_ENABLE_FILE_SHARING` | `true` | File/folder sharing |
+| `OXICLOUD_ENABLE_TRASH` | `true` | Trash / recycle bin |
+| `OXICLOUD_ENABLE_SEARCH` | `true` | Search |
+
+## OIDC / SSO
+
+See the [OIDC configuration guide](/config/oidc) for details.
+
+| Variable | Default | Description |
+|---|---|---|
+| `OXICLOUD_OIDC_ENABLED` | `false` | Enable OIDC |
+| `OXICLOUD_OIDC_ISSUER_URL` | — | OIDC issuer URL |
+| `OXICLOUD_OIDC_CLIENT_ID` | — | Client ID |
+| `OXICLOUD_OIDC_CLIENT_SECRET` | — | Client secret |
+| `OXICLOUD_OIDC_REDIRECT_URI` | `http://localhost:8086/api/auth/oidc/callback` | Callback URL |
+| `OXICLOUD_OIDC_SCOPES` | `openid profile email` | Requested scopes |
+| `OXICLOUD_OIDC_FRONTEND_URL` | `http://localhost:8086` | Frontend URL |
+| `OXICLOUD_OIDC_AUTO_PROVISION` | `true` | Auto-create users on first SSO login |
+| `OXICLOUD_OIDC_ADMIN_GROUPS` | — | Groups that grant admin role |
+| `OXICLOUD_OIDC_DISABLE_PASSWORD_LOGIN` | `false` | Hide password form when OIDC enabled |
+| `OXICLOUD_OIDC_PROVIDER_NAME` | `SSO` | Display name for the provider |
+
+## WOPI (Office Editing)
+
+See the [WOPI configuration guide](/config/wopi) for details.
+
+| Variable | Default | Description |
+|---|---|---|
+| `OXICLOUD_WOPI_ENABLED` | `false` | Enable WOPI |
+| `OXICLOUD_WOPI_DISCOVERY_URL` | — | Collabora/OnlyOffice discovery URL |
+| `OXICLOUD_WOPI_SECRET` | (JWT secret) | WOPI token signing key |
+| `OXICLOUD_WOPI_TOKEN_TTL_SECS` | `86400` | Token lifetime |
+| `OXICLOUD_WOPI_LOCK_TTL_SECS` | `1800` | Lock expiration |
+
+## Internal Defaults (not configurable via env)
+
+| Parameter | Default |
+|---|---|
+| File cache TTL | 60 s |
+| Directory cache TTL | 120 s |
+| Max cache entries | 10 000 |
+| Large file threshold | 100 MB |
+| Streaming chunk size | 1 MB |
+| Max parallel chunks | 8 |
+| Trash retention | 30 days |
+| Argon2id memory cost | 64 MB |
+| Argon2id time cost | 3 iterations |