docs: tighten the Milvus migration warning

This commit is contained in:
Classic298 2026-10-01 06:54:39 +00:00
parent d52050fc9c
commit ba7eaa3ea0
No known key found for this signature in database

View file

@ -191,7 +191,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
### Changed
- ⚠️ **IMPORTANT for Milvus and Milvus multitenancy users: back up your Milvus data before upgrading**: On its first start with "ENABLE_DB_MIGRATIONS" on (the default), this release rebuilds every existing Milvus collection so its vectors, text and BM25 keyword index live together, and Open WebUI only finishes starting once that is done; every collection is copied in full, vectors included, so hundreds of gigabytes can take hours, and it needs free disk space for a second copy of all your Milvus data until it finishes. Nothing is re-embedded, and the original collections are only dropped after every copy has succeeded: a failed run changes nothing and is retried on the next start. No testing covers every setup, so back up first and avoid upgrading Milvus and Open WebUI on the same day where you can. Hybrid search on Milvus needs Milvus 2.5 or newer; on 2.4 and older the migration is skipped and there is no native hybrid search. [#31645](https://github.com/open-webui/open-webui/pull/31645), [#31660](https://github.com/open-webui/open-webui/pull/31660)
- ⚠️ **IMPORTANT for Milvus and Milvus multitenancy users: back up your Milvus data before upgrading**: On first start with "ENABLE_DB_MIGRATIONS" on (the default), every existing Milvus collection is copied in full into a new one holding its vectors, text and BM25 keyword index together, and Open WebUI only finishes starting once that is done, which can take hours for hundreds of gigabytes and needs free disk space for a second copy of your Milvus data. Nothing is re-embedded, and the originals are only dropped once every copy has succeeded, so a failed run changes nothing and is retried on the next start. Back up first and avoid upgrading Milvus and Open WebUI on the same day. Hybrid search on Milvus needs Milvus 2.5 or newer; on older versions the migration is skipped and there is no native hybrid search. [#31645](https://github.com/open-webui/open-webui/pull/31645), [#31660](https://github.com/open-webui/open-webui/pull/31660)
- 🔌 **ENABLE_PLUGINS is the master switch.** Setting "ENABLE_PLUGINS=false" now turns off every kind of plugin, including external OpenAPI, MCP and Open Terminal servers and personal direct connections, and overrides "ENABLE_TOOLS", "ENABLE_FUNCTIONS" and "ENABLE_TOOL_SERVERS"; all four need a restart to take effect. [Commit](https://github.com/open-webui/open-webui/commit/f50f9e6252209760d0b96f090766e91fb826ecba), [#31509](https://github.com/open-webui/open-webui/issues/31509)
- ⚡ **orjson on by default.** "ENABLE_ORJSON" now defaults to on, and setting "ENABLE_ORJSON=false" switches back to the standard JSON encoder. [#31616](https://github.com/open-webui/open-webui/pull/31616)
- 🔁 **Update Redis-backed instances together.** Where several servers share their websocket traffic through Redis, every instance should be updated at the same time, since live chat updates sent by an updated instance do not reach one still on an older version unless "WEBSOCKET_REDIS_ROOM_CHANNELS" is set to false. [#28818](https://github.com/open-webui/open-webui/pull/28818)