[PR #1081] [MERGED] Document ChromaDB SQLite limitation for multi-worker/multi-replica de… #1078

New issue

Closed

opened 2026-10-18 14:16:53 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-18 14:16:53 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/docs/pull/1081
Author: @Classic298
Created: 2/16/2026
Status: ✅ Merged
Merged: 2/16/2026
Merged by: @Classic298

Base: dev ← Head: claude/update-docs-chroma-db-Wya2W

📝 Commits (2)

c270f4b Document ChromaDB SQLite limitation for multi-worker/multi-replica deployments
cf5aeae Update rag.mdx

📊 Changes

8 files changed (+148 additions, -27 deletions)

View changed files

📝 docs/enterprise/architecture.md (+3 -1)
📝 docs/getting-started/quick-start/tab-docker/DockerSwarm.md (+10 -0)
📝 docs/getting-started/quick-start/tab-kubernetes/Helm.md (+3 -1)
📝 docs/reference/env-configuration.mdx (+31 -1)
📝 docs/troubleshooting/multi-replica.mdx (+43 -3)
📝 docs/troubleshooting/performance.md (+5 -4)
📝 docs/troubleshooting/rag.mdx (+39 -17)
📝 docs/tutorials/integrations/redis.md (+14 -0)

📄 Description

…ployments

ChromaDB's default local PersistentClient uses SQLite which is not fork-safe. When uvicorn forks multiple workers, concurrent writes crash workers instantly. Added warnings and guidance across env config, HA/scaling, performance, troubleshooting, Docker Swarm, Helm, Redis, RAG, and enterprise architecture docs.

https://claude.ai/code/session_01TPoquFdHG6dZxRrZ4Jormh

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/open-webui/docs/pull/1081 **Author:** [@Classic298](https://github.com/Classic298) **Created:** 2/16/2026 **Status:** ✅ Merged **Merged:** 2/16/2026 **Merged by:** [@Classic298](https://github.com/Classic298) **Base:** `dev` ← **Head:** `claude/update-docs-chroma-db-Wya2W` --- ### 📝 Commits (2) - [`c270f4b`](https://github.com/open-webui/docs/commit/c270f4b9340f02fd1279f77d6339e74fb147412a) Document ChromaDB SQLite limitation for multi-worker/multi-replica deployments - [`cf5aeae`](https://github.com/open-webui/docs/commit/cf5aeae702732dcd2cdc423bfeb1ac5c9b435884) Update rag.mdx ### 📊 Changes **8 files changed** (+148 additions, -27 deletions) <details> <summary>View changed files</summary> 📝 `docs/enterprise/architecture.md` (+3 -1) 📝 `docs/getting-started/quick-start/tab-docker/DockerSwarm.md` (+10 -0) 📝 `docs/getting-started/quick-start/tab-kubernetes/Helm.md` (+3 -1) 📝 `docs/reference/env-configuration.mdx` (+31 -1) 📝 `docs/troubleshooting/multi-replica.mdx` (+43 -3) 📝 `docs/troubleshooting/performance.md` (+5 -4) 📝 `docs/troubleshooting/rag.mdx` (+39 -17) 📝 `docs/tutorials/integrations/redis.md` (+14 -0) </details> ### 📄 Description …ployments ChromaDB's default local PersistentClient uses SQLite which is not fork-safe. When uvicorn forks multiple workers, concurrent writes crash workers instantly. Added warnings and guidance across env config, HA/scaling, performance, troubleshooting, Docker Swarm, Helm, Redis, RAG, and enterprise architecture docs. https://claude.ai/code/session_01TPoquFdHG6dZxRrZ4Jormh --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-18 14:16:53 +00:00