Skip to content

Add vector DB requirements and correct storage guidance in scaling guide#1084

Merged
Classic298 merged 7 commits intoopen-webui:devfrom
Classic298:claude/update-docs-chroma-db-Wya2W
Feb 16, 2026
Merged

Add vector DB requirements and correct storage guidance in scaling guide#1084
Classic298 merged 7 commits intoopen-webui:devfrom
Classic298:claude/update-docs-chroma-db-Wya2W

Conversation

@Classic298
Copy link
Collaborator

No description provided.

claude and others added 6 commits February 16, 2026 12:51
- Added Step 4 (Switch to External Vector Database) explaining why default
  ChromaDB crashes in multi-process setups, with a comparison table of
  alternatives (PGVector, Milvus, Qdrant, Pinecone, ChromaDB HTTP mode)
- Corrected Step 5 (file storage): shared filesystem (NFS) is sufficient,
  cloud storage (S3) is optional. Files use UUID-based names so no write
  conflicts occur between processes.
- Updated architecture diagram, env var examples, and quick reference table
  to include vector DB column and clarify storage requirements.

https://claude.ai/code/session_01TPoquFdHG6dZxRrZ4Jormh
- scaling.md: Link each step to relevant troubleshooting sections
  (DB corruption, WebSocket errors, login loops, worker crashes,
  file access issues, logging, OpenTelemetry)
- multi-replica.mdx: Add scaling guide link in intro and Related Docs,
  plus links to Redis and RAG troubleshooting
- performance.md: Add scaling guide link in Scaling Infrastructure section
- redis.md: Add scaling guide link in "When is Redis Required?"
- connection-error.mdx: Add links to Redis tutorial, scaling guide,
  and multi-replica WebSocket troubleshooting
- Helm.md: Add scaling guide link alongside existing HA guide link

https://claude.ai/code/session_01TPoquFdHG6dZxRrZ4Jormh
- OpenAI page: Focus on OpenAI/Azure only, link to compatible page
  for all other providers
- OpenAI-Compatible page: Complete rewrite with tabbed provider guides
  - Cloud tabs: Anthropic, Google Gemini, DeepSeek, Mistral, Groq,
    Perplexity, MiniMax, OpenRouter, Amazon Bedrock
  - Local tabs: Lemonade, LM Studio, vLLM, LocalAI, Docker Model Runner
  - Added prominent warning about /models endpoint failing for some
    providers (Anthropic, Perplexity, MiniMax) with solution table
  - Fixed Google Gemini URL (removed trailing slash)
- Deleted minimax.md and amazon-bedrock.md tutorials (content moved
  into the compatible page tabs)

https://claude.ai/code/session_01TPoquFdHG6dZxRrZ4Jormh
- Cloud Providers: Added Azure OpenAI tab (with provider type toggle
  instructions and link to EntraID tutorial) and LiteLLM tab
- Local Servers: Added Llama.cpp tab with quick start command and
  link to the dedicated Llama.cpp guide

https://claude.ai/code/session_01TPoquFdHG6dZxRrZ4Jormh
@pr-validator-bot
Copy link

ℹ️ Documentation PR Guidelines

👋 Welcome! This is an automated message posted on all new documentation PRs to help guide our contributors. Just because this comment appeared doesn't mean you have done anything wrong!

Please ensure you're using the correct branches:

Target branch (where you're merging TO):

  • dev branch: For documentation related to upcoming Open WebUI releases (new features, new environment variables, anything dependent on unreleased versions and unreleased features/fixes/changes)
  • main branch: For content that can go live immediately (fixes, tutorials, documentation not dependent on unreleased features)

Source branch (where you're merging FROM):

  • If targeting dev, create your branch from your fork's dev branch
  • If targeting main, create your branch from your fork's main branch
  • ⚠️ Mismatched branches can and will result in unwanted file changes being included in your PR!

If your docs PR depends on a pending PR in open-webui/open-webui:

  • Convert this PR to DRAFT mode!
  • Link to the related main repo PR in your description for clarity
  • We'll review both together once the PR on the main repo is merged

Please adjust your PR target branch, source branch, and/or draft status accordingly if needed.

… and Lemonade tabs

The previous restructuring condensed detailed provider tutorials into minimal
tabs, dropping all screenshots and step-by-step instructions. This restores:
- MiniMax: full 4-step guide with all 4 screenshots (API key, connection, chat)
- Amazon Bedrock: full 4-step guide with all 4 screenshots (models, BAG, connection, UI)
- Lemonade: installation steps with server and connection screenshots

https://claude.ai/code/session_01TPoquFdHG6dZxRrZ4Jormh
@Classic298 Classic298 merged commit e9e007d into open-webui:dev Feb 16, 2026
1 check passed
@Classic298 Classic298 deleted the claude/update-docs-chroma-db-Wya2W branch February 16, 2026 14:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants