[PR #1383] [MERGED] Correct the fresh-install note for OFFLINE_MODE: the container starts, the first embedding call fails #1349

New issue

Closed

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

bsakaguchi commented

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

Owner

📋 Pull Request Information

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

Base: main ← Head: fix/offline-mode-fresh-install-wording

📝 Commits (1)

871e84d Correct the fresh-install note for OFFLINE_MODE: the container starts, the first embedding call fails

📊 Changes

1 file changed (+1 additions, -1 deletions)

View changed files

📝 docs/reference/env-configuration.mdx (+1 -1)

📄 Description

Summary

The OFFLINE_MODE reference entry says that on a fresh install the flag "aborts startup with No embedding model is loaded". That was the 0.9.6 behavior. Since 0.10.0 the container starts, and the failure surfaces on the first document upload or RAG query. The linked troubleshooting page already says so, and initialize_runtime_config in main.py catches the embedding load error and logs it rather than exiting. The two pages now agree.

None. One-line correction to match the troubleshooting page and the code.

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

The corrected sentence keeps the existing link to the troubleshooting entry. That entry reads "The container starts ... and the first document upload or RAG query then fails with the ValueError", and it notes that 0.9.6 aborted startup instead, fixed in 0.10.0. I started today's :main image with OFFLINE_MODE=true on an empty named volume, and the container reported healthy and kept running.

_{🔄 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/1383 **Author:** [@silentoplayz](https://github.com/silentoplayz) **Created:** 9/7/2026 **Status:** ✅ Merged **Merged:** 9/7/2026 **Merged by:** [@silentoplayz](https://github.com/silentoplayz) **Base:** `main` ← **Head:** `fix/offline-mode-fresh-install-wording` --- ### 📝 Commits (1) - [`871e84d`](https://github.com/open-webui/docs/commit/871e84d2ed2c4a66b40f0e6de164686258f97b73) Correct the fresh-install note for OFFLINE_MODE: the container starts, the first embedding call fails ### 📊 Changes **1 file changed** (+1 additions, -1 deletions) <details> <summary>View changed files</summary> 📝 `docs/reference/env-configuration.mdx` (+1 -1) </details> ### 📄 Description ## Summary The `OFFLINE_MODE` reference entry says that on a fresh install the flag "aborts startup with `No embedding model is loaded`". That was the 0.9.6 behavior. Since 0.10.0 the container starts, and the failure surfaces on the first document upload or RAG query. The linked troubleshooting page already says so, and `initialize_runtime_config` in `main.py` catches the embedding load error and logs it rather than exiting. The two pages now agree. ## Related issue or discussion None. One-line correction to match the troubleshooting page and the code. ## 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 The corrected sentence keeps the existing link to the troubleshooting entry. That entry reads "The container starts ... and the first document upload or RAG query then fails with the `ValueError`", and it notes that 0.9.6 aborted startup instead, fixed in 0.10.0. I started today's `:main` image with `OFFLINE_MODE=true` on an empty named volume, and the container reported healthy and kept running. --- <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:03 +00:00