This commit is contained in:
+8
-2
@@ -98,12 +98,18 @@ The workspace displays original/modified SVGs side by side with synchronized zoo
|
||||
|
||||
## Storage and configuration
|
||||
|
||||
Local files are private, written atomically with generated keys. Client filenames never determine storage paths. For private S3-compatible storage set the same `S3_BUCKET`, `S3_ENDPOINT_URL`, AWS credentials and region on API and workers; no bucket ACL or public URL is created. Prefer workload credentials/IAM and configure bucket encryption/lifecycle at the provider. On a multi-host deployment use S3; a Docker named volume is shared only on one host. Storage/database orphan reconciliation after a machine failure is an operational maintenance task; normal completion, retries and expiry cleanup are implemented.
|
||||
Local files are private, written atomically with generated keys. Client filenames never determine storage paths. For private S3-compatible storage set `STORAGE_BACKEND=s3` and the same `S3_BUCKET`, `S3_PREFIX`, `S3_ENDPOINT_URL`, credentials and region on API and workers; no bucket ACL or public URL is created. Prefer workload credentials/IAM and configure bucket encryption/lifecycle at the provider. On a multi-host deployment use S3; a Docker named volume is shared only on one host. Storage/database orphan reconciliation after a machine failure is an operational maintenance task; normal completion, retries and expiry cleanup are implemented.
|
||||
|
||||
Full settings, credentials, optional encryption, migration instructions and the local-versus-temporary-file boundary are documented in [S3 storage](docs/S3.md). Existing local files are not moved automatically; a verified, non-deleting migration utility is provided.
|
||||
|
||||
| Environment | Default |
|
||||
| --- | --- |
|
||||
| `DATABASE_URL` | SQLite under `STORAGE_DIR`; Compose uses PostgreSQL |
|
||||
| `STORAGE_DIR` | `./data` (`/data` in Compose) |
|
||||
| `STORAGE_DIR` | `./data` (`/data` in Compose); local objects / SQLite metadata only |
|
||||
| `STORAGE_BACKEND` | `auto`: S3 when bucket is set, local otherwise; `s3` requires S3 |
|
||||
| `S3_BUCKET` / `S3_PREFIX` | Existing private bucket / optional object namespace |
|
||||
| `S3_ENDPOINT_URL` / `S3_REGION` | Provider endpoint / region (AWS default endpoint when blank) |
|
||||
| `S3_ADDRESSING_STYLE` | `auto`, `path` or `virtual` |
|
||||
| `API_KEY` | Empty in local development; required in production |
|
||||
| `PUBLIC_BASE_URL` | `http://127.0.0.1:8000` |
|
||||
| `MAX_UPLOAD_BYTES` | 33,554,432 (32 MiB) |
|
||||
|
||||
مرجع در شماره جدید
مسدود کردن کاربر