danvics/openreader
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(env): clarify local vs worker compute env ownership

Browse source
This commit is contained in:
Richard R 2026-05-21 20:58:32 -06:00
parent a29e6fc250
commit d8c6d00de6
2 changed files with 13 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
docs-site/docs/deploy/compute-worker.md
View file

@ -74,6 +74,8 @@ COMPUTE_WORKER_TOKEN=<same-token-as-worker>
# COMPUTE_PDF_TIMEOUT_MS=300000
```
Model artifact overrides (`WHISPER_MODEL_BASE_URL`, `PDF_LAYOUT_MODEL_BASE_URL`) are worker runtime variables and should be set on the compute worker service environment.
`COMPUTE_MODE=worker` has no local fallback. If worker is unavailable, affected requests fail.
## Production notes

11
docs-site/docs/reference/environment-variables.md
View file

@ -56,6 +56,7 @@ For auth-enabled deployments, use **Settings → Admin** as the primary source o
| `COMPUTE_MODE` | Heavy compute backend | `local` | Select `local` (in-process) or `worker` (external worker service) |
| `COMPUTE_WORKER_URL` | Heavy compute backend | unset | Required when `COMPUTE_MODE=worker`; base URL for external compute worker |
| `COMPUTE_WORKER_TOKEN` | Heavy compute backend | unset | Required bearer token for external compute worker auth |
| `COMPUTE_JOB_CONCURRENCY` | Heavy compute backend | `1` | Local in-process compute concurrency cap; set worker service concurrency in compute-worker env/docs |
| `COMPUTE_WHISPER_TIMEOUT_MS` | Heavy compute backend | `30000` | Shared whisper alignment timeout budget (local + worker + worker client wait budget) |
| `COMPUTE_PDF_TIMEOUT_MS` | Heavy compute backend | `300000` | Shared PDF idle-timeout budget (local + worker + worker client wait budget) |
| `PDF_LAYOUT_MODEL_BASE_URL` | PDF layout model | PP-DocLayoutV3 ONNX base URL | Optional base URL override for `ensureModel()` |
@ -379,6 +380,14 @@ Bearer token for external compute worker auth.
- Used only when `COMPUTE_MODE=worker`
- Must match worker service `COMPUTE_WORKER_TOKEN`
### COMPUTE_JOB_CONCURRENCY
In-process compute concurrency cap for app-server local compute mode.
- Default: `1`
- Applies when `COMPUTE_MODE=local`
- For `COMPUTE_MODE=worker`, set worker-side `COMPUTE_JOB_CONCURRENCY` in [Compute Worker (NATS JetStream)](../deploy/compute-worker)
### COMPUTE_WHISPER_TIMEOUT_MS
Shared whisper alignment timeout budget in milliseconds.
@ -409,6 +418,7 @@ Optional base URL override for PP-DocLayoutV3 artifacts downloaded by `ensureMod
- `PP-DocLayoutV3.onnx.data`
- `config.json`
- `preprocessor_config.json`
- In `COMPUTE_MODE=worker`, configure this on the worker service env (not only the app server env)
### WHISPER_MODEL_BASE_URL
@ -417,6 +427,7 @@ Optional base URL override for the built-in ONNX Whisper alignment model downloa
- Default: `https://huggingface.co/onnx-community/whisper-base_timestamped/resolve/main`
- Default model variant: int8 (`encoder_model_int8.onnx`, `decoder_model_merged_int8.onnx`, `decoder_with_past_model_int8.onnx`)
- The base URL must host all expected manifest files under the same relative paths.
- In `COMPUTE_MODE=worker`, configure this on the worker service env (not only the app server env)
### FFMPEG_BIN