Diocrafts
f08cffc0e8
- 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
3.1 KiB
3.1 KiB
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 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 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 |