open-notebook/docs/5-CONFIGURATION
Luis Novo d6c33151ab
feat(worker): expose OPEN_NOTEBOOK_WORKER_MAX_TASKS to control worker concurrency (#1141)
The worker processes all queued tasks up to a fixed concurrency of 5, which
overloads single-GPU / local-LLM setups and triggers rate limits (#893). The
surreal-commands worker already accepts --max-tasks; wire it to a new
OPEN_NOTEBOOK_WORKER_MAX_TASKS env var (default 5, set 1 for sequential) at
every launch point.

- Makefile (worker-start, start-all): --max-tasks "$${VAR:-5}" (Make-escaped)
- dev-init.sh: POSIX ${VAR:-5} default expansion
- supervisord.conf: wrap in sh -c so the shell expands the var (command= does
  not run through a shell)
- docker-compose.yml: commented environment example
- .env.example + environment-reference.md: document it, incl. the launch-time
  sourcing behavior

Also fixes a phantom doc entry: SURREAL_COMMANDS_MAX_TASKS was documented but
is not read anywhere (the worker's --max-tasks Typer option has no envvar);
replaced with the real OPEN_NOTEBOOK_WORKER_MAX_TASKS.

Closes #893
2026-07-14 12:28:48 -03:00
..
advanced.md feat(sources): opt-in Docling + Crawl4AI runtimes installed at startup (#1122) (#1123) 2026-07-13 08:26:20 -03:00
ai-providers.md fix: remove deprecated gemini models (#1027) 2026-07-10 15:59:56 -03:00
database.md docs: stop teaching 0.0.0.0 SurrealDB port exposure in setup snippets (#1060) 2026-07-12 08:42:52 -03:00
environment-reference.md feat(worker): expose OPEN_NOTEBOOK_WORKER_MAX_TASKS to control worker concurrency (#1141) 2026-07-14 12:28:48 -03:00
index.md feat: credential-based API key management (#477) (#540) 2026-02-10 08:30:22 -03:00
local-stt.md feat: credential-based API key management (#477) (#540) 2026-02-10 08:30:22 -03:00
local-tts.md feat: credential-based API key management (#477) (#540) 2026-02-10 08:30:22 -03:00
mcp-integration.md feat: add MCP integration documentation to README and create dedicated MCP integration guide 2026-01-09 08:14:39 -03:00
ollama.md docs: add surrealdb service notes to docker-compose snippets 2026-04-06 08:15:33 -03:00
openai-compatible.md docs: stop teaching 0.0.0.0 SurrealDB port exposure in setup snippets (#1060) 2026-07-12 08:42:52 -03:00
reverse-proxy.md fix(docker): force frontend bind address in supervisord so injected HOSTNAME can't break it (#1059) 2026-07-12 09:30:38 -03:00
security.md chore: remove dead auth helper and fix stale default-password docs (#1026) 2026-07-10 15:47:40 -03:00