[PR #481] [MERGED] add: Info/Warning for setting up multi-instance setups #562

New issue

Closed

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

bsakaguchi commented

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

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/docs/pull/481
Author: @Classic298
Created: 4/8/2025
Status: ✅ Merged
Merged: 4/8/2025
Merged by: @tjbck

Base: main ← Head: main

📝 Commits (3)

121d9d2 Update Kustomize.md
8f70c13 Update Helm.md
6da02f7 Update env-configuration.md

📊 Changes

3 files changed (+38 additions, -0 deletions)

View changed files

📝 docs/getting-started/env-configuration.md (+24 -0)
📝 docs/getting-started/quick-start/tab-kubernetes/Helm.md (+7 -0)
📝 docs/getting-started/quick-start/tab-kubernetes/Kustomize.md (+7 -0)

📄 Description

Recently, many users were confused on why their kubernetes setup or multi-worker setup was not functioning properly.

I have decided to try to improve the docs in this regard.

Adds info blocks to Redis environment variables, notifying the user of the need of setting these environment variables when trying to host Open WebUI in a multi-node/worker/instance environment
Adds a warning block when choosing the kustomize quick-setup that informs the user to also set up the needed environment variables for scalable setups
Adds a warning block when choosing the helm quick-setup that informs the user to also set up the needed environment variables for scalable setups

Relates to:
https://github.com/open-webui/open-webui/issues/10365#issuecomment-2784050405

https://github.com/open-webui/open-webui/discussions/9032
https://github.com/open-webui/open-webui/discussions/12362
https://github.com/open-webui/open-webui/issues/12286

_{🔄 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/481 **Author:** [@Classic298](https://github.com/Classic298) **Created:** 4/8/2025 **Status:** ✅ Merged **Merged:** 4/8/2025 **Merged by:** [@tjbck](https://github.com/tjbck) **Base:** `main` ← **Head:** `main` --- ### 📝 Commits (3) - [`121d9d2`](https://github.com/open-webui/docs/commit/121d9d256fc9e554b207a0a8a3f43d1af6353ae3) Update Kustomize.md - [`8f70c13`](https://github.com/open-webui/docs/commit/8f70c131bc8af7fda95e87b3f9a11066e6cd12b2) Update Helm.md - [`6da02f7`](https://github.com/open-webui/docs/commit/6da02f72cea4508e33f5d6eec2ff2420dba96e5e) Update env-configuration.md ### 📊 Changes **3 files changed** (+38 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `docs/getting-started/env-configuration.md` (+24 -0) 📝 `docs/getting-started/quick-start/tab-kubernetes/Helm.md` (+7 -0) 📝 `docs/getting-started/quick-start/tab-kubernetes/Kustomize.md` (+7 -0) </details> ### 📄 Description Recently, many users were confused on why their kubernetes setup or multi-worker setup was not functioning properly. I have decided to try to improve the docs in this regard. - Adds info blocks to Redis environment variables, notifying the user of the need of setting these environment variables when trying to host Open WebUI in a multi-node/worker/instance environment - Adds a warning block when choosing the kustomize quick-setup that informs the user to also set up the needed environment variables for scalable setups - Adds a warning block when choosing the helm quick-setup that informs the user to also set up the needed environment variables for scalable setups Relates to: https://github.com/open-webui/open-webui/issues/10365#issuecomment-2784050405 https://github.com/open-webui/open-webui/discussions/9032 https://github.com/open-webui/open-webui/discussions/12362 https://github.com/open-webui/open-webui/issues/12286 --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

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