[PR #1410] [MERGED] docs: correct the connection error, context window and multi-replica troubleshooting pages against the code #1376

New issue

Closed

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

bsakaguchi commented

2026-10-18 14:19:14 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/docs/pull/1410
Author: @silentoplayz
Created: 9/18/2026
Status: ✅ Merged
Merged: 9/18/2026
Merged by: @Classic298

Base: main ← Head: docs/troubleshooting-core-pages

📝 Commits (1)

e8756df docs: correct the connection error, context window and multi-replica troubleshooting pages against the code

📊 Changes

3 files changed (+14 additions, -14 deletions)

View changed files

📝 docs/troubleshooting/connection-error.mdx (+6 -6)
📝 docs/troubleshooting/context-window.mdx (+4 -4)
📝 docs/troubleshooting/multi-replica.mdx (+4 -4)

📄 Description

Summary

I compared the connection error, context window and multi-replica troubleshooting pages with config.py, env.py, the Ollama and OpenAI routers, utils/context_compaction.py, internal/db.py and models/config.py on dev.

Connection error: the config table has one row per key since v0.10.0, so the DELETE ... WHERE id LIKE command deletes nothing and is replaced with the working form. AIOHTTP_CLIENT_TIMEOUT is unset by default, endpoints are queried concurrently so bad endpoints do not compound, Open WebUI registers no service worker (it unregisters any it finds), and database session sharing is off by default so it is not a fix unless it was switched on.
Context window: compaction shows a toast, the summary is written by the chat's own model unless a compaction model is set (the task model is never consulted), and source in the usage response is always estimated.
Multi-replica: the async PostgreSQL driver is psycopg v3 since v0.9.2 and +asyncpg URLs fail, and configuration is read from the shared database on each access, so there is no Redis Pub/Sub for settings. The page now says what Redis does provide.

None.

Checklist

I have reviewed the relevant documentation and matched the existing style.
This PR meets Open WebUI's contribution standards: it is accurate, relevant to users, narrowly scoped, maintainable, and not promotional content, advertising, lead generation, SEO placement, or a request to list a product, service, provider, integration, gateway, tool, or company primarily for visibility.
I understand that PRs that do not meet these standards may be closed without review and will not be merged. Repeated, low-quality, off-topic, promotional, or intentionally misleading submissions may result in the contributor being blocked from future participation in Open WebUI repositories.

Notes for reviewers

Sources on dev: models/config.py for the table shape, the asyncio.gather calls in both model routers, unregisterServiceWorkers in the root layout, context_compaction.py for the model choice and the usage dict, and internal/db.py for the driver rewrite.

_{🔄 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/1410 **Author:** [@silentoplayz](https://github.com/silentoplayz) **Created:** 9/18/2026 **Status:** ✅ Merged **Merged:** 9/18/2026 **Merged by:** [@Classic298](https://github.com/Classic298) **Base:** `main` ← **Head:** `docs/troubleshooting-core-pages` --- ### 📝 Commits (1) - [`e8756df`](https://github.com/open-webui/docs/commit/e8756df310791715268d1085e84e900b609fb691) docs: correct the connection error, context window and multi-replica troubleshooting pages against the code ### 📊 Changes **3 files changed** (+14 additions, -14 deletions) <details> <summary>View changed files</summary> 📝 `docs/troubleshooting/connection-error.mdx` (+6 -6) 📝 `docs/troubleshooting/context-window.mdx` (+4 -4) 📝 `docs/troubleshooting/multi-replica.mdx` (+4 -4) </details> ### 📄 Description ## Summary I compared the connection error, context window and multi-replica troubleshooting pages with `config.py`, `env.py`, the Ollama and OpenAI routers, `utils/context_compaction.py`, `internal/db.py` and `models/config.py` on `dev`. - Connection error: the config table has one row per key since v0.10.0, so the `DELETE ... WHERE id LIKE` command deletes nothing and is replaced with the working form. `AIOHTTP_CLIENT_TIMEOUT` is unset by default, endpoints are queried concurrently so bad endpoints do not compound, Open WebUI registers no service worker (it unregisters any it finds), and database session sharing is off by default so it is not a fix unless it was switched on. - Context window: compaction shows a toast, the summary is written by the chat's own model unless a compaction model is set (the task model is never consulted), and `source` in the usage response is always `estimated`. - Multi-replica: the async PostgreSQL driver is psycopg v3 since v0.9.2 and `+asyncpg` URLs fail, and configuration is read from the shared database on each access, so there is no Redis Pub/Sub for settings. The page now says what Redis does provide. ## Related issue or discussion None. ## Checklist - [x] I have reviewed the relevant documentation and matched the existing style. - [x] This PR meets Open WebUI's contribution standards: it is accurate, relevant to users, narrowly scoped, maintainable, and not promotional content, advertising, lead generation, SEO placement, or a request to list a product, service, provider, integration, gateway, tool, or company primarily for visibility. - [x] I understand that PRs that do not meet these standards may be closed without review and will not be merged. Repeated, low-quality, off-topic, promotional, or intentionally misleading submissions may result in the contributor being blocked from future participation in Open WebUI repositories. ## Notes for reviewers Sources on `dev`: `models/config.py` for the table shape, the `asyncio.gather` calls in both model routers, `unregisterServiceWorkers` in the root layout, `context_compaction.py` for the model choice and the usage dict, and `internal/db.py` for the driver rewrite. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-18 14:19:14 +00:00