Skip to content

Dev#1109

Open
Classic298 wants to merge 13 commits intoopen-webui:devfrom
Classic298:dev
Open

Dev#1109
Classic298 wants to merge 13 commits intoopen-webui:devfrom
Classic298:dev

Conversation

@Classic298
Copy link
Collaborator

No description provided.

@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.

Classic298 and others added 8 commits February 26, 2026 21:04
… vars

- Add TERMINAL_SERVER_CONNECTIONS env var documentation
- Rewrite 'Connecting to Open WebUI' with admin-configured, user-configured, and generic methods
- Document terminal selector (System vs Direct), enable/disable toggles, access control
- Document authentication types (Bearer, Session, OAuth, None)
- Update display_file endpoint to note native Open WebUI event handling
- Add CSV/TSV preview to file browser capabilities
- Rename 'Admin Settings → Tools' to 'Admin Settings → Integrations' (skills.md, open-terminal)
…tive

- Mark Default (prompt-based) tool calling as legacy; recommend Native Mode
  - Document KV cache breaking in Default Mode, system tools only in Native
  - Updated comparison table with Status, KV Cache, System Tools rows
- Add Content Extraction Engine section (pypdf memory leak warning, Tika/Docling)
- Add Embedding Engine section (SentenceTransformers RAM warning at scale)
- Add Common Anti-Patterns section with 6 real-world scaling mistakes
- Add Redis Tuning subsection (timeout, maxclients, single instance sufficiency)
- Expand Profile 3 with content extraction, embeddings, tool calling, Redis
- New Step 6 in scaling guide: Fix Content Extraction & Embeddings
- Quick reference table: add Ext. Content Extraction and Ext. Embeddings columns
- Add CONTENT_EXTRACTION_ENGINE and RAG_EMBEDDING_ENGINE to minimum env vars
- Add Networking & Connectivity section to Open Terminal docs
  - Request origin table (admin=backend, user=browser)
  - Common symptoms table (502, localhost resolution, timeouts)
  - Warning about same URL different results with reverse proxy example
  - Quick test command to verify backend reachability
- Add general Frontend vs Backend Connections section to connection-error.mdx
  - Core rule table explaining what localhost means in each context
  - Cross-references to Open Terminal and Tool Server networking docs
  - Covers the #1 source of connection confusion across all features
- Add warning to MCP auth section explaining the interactive browser
  redirect requirement that prevents OAuth 2.1 tools from working
  as default/pre-enabled tools on models
- Add troubleshooting entry for 'Failed to connect to MCP server'
  when caused by OAuth 2.1 default tool misconfiguration
- Document workaround: manually enable per-chat via + button
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.

2 participants