v2.2 · 2026-06-12
Open WebUI cannot connect
troubleshooting · ready for authoring
This usually points to server address, Docker networking, provider settings, or service startup. Start with the simplest visible checks before changing advanced settings.
DIAGNOSTIC_OVERVIEW
This usually points to server address, Docker networking, provider settings, or service startup. Start with the simplest visible checks before changing advanced settings.
Stop troubleshooting and switch paths when the workflow involves confidential documents and you cannot explain where prompts, files, embeddings, logs, and provider calls go.
SYMPTOMS
The local AI workflow does not behave as expected.
Local AI Guide has not independently reproduced this diagnostic.
LIKELY_CAUSES
Ollama server address, Docker networking, or service startup may be misconfigured.
FIRST_FIXES
Confirm the exact app, model, route, and error text.
Check whether the selected model is realistic for the machine’s RAM, VRAM, and context length.
Confirm whether the issue is a local runtime problem, a UI/provider problem, or a document/retrieval problem.
STOP_AND_SWITCH_WHEN
The workflow involves confidential data and the local/private boundary is unclear.
The hardware cannot realistically fit the selected model.
Stop troubleshooting and switch paths when the workflow involves confidential documents and you cannot explain where prompts, files, embeddings, logs, and provider calls go.
EVIDENCE
Official documentation reviewed with caveatsreviewed: 2026-05-24
Official documentation reviewed, with caveats
CAVEATS
Not a substitute for current official documentation.
Exact fix depends on runtime, OS, hardware, and model.