[PR #1126] [MERGED] docs: add beginner-safe Unraid deployment guide #1123

New issue

Closed

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

bsakaguchi commented

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

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/docs/pull/1126
Author: @idanzairi302
Created: 3/4/2026
Status: ✅ Merged
Merged: 3/4/2026
Merged by: @Classic298

Base: main ← Head: codex/unraid-beginner-safe-docs

📝 Commits (2)

fcae985 docs: add beginner-safe Unraid deployment guide
fafb49f docs: move Unraid guide to tutorials/integrations

📊 Changes

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

View changed files

➕ docs/tutorials/integrations/unraid.md (+143 -0)

📄 Description

Summary

Adds a beginner-safe Unraid guide to the docs site and links it from Getting Started and troubleshooting entry points.

This PR moves the work that was previously submitted to open-webui/open-webui into the correct repository (open-webui/docs) per maintainer guidance.

Changes

Added new page: docs/getting-started/unraid.md
- step-by-step Unraid Docker template config
- persistent volume guidance
- safe upgrade workflow
- troubleshooting for:
  - cannot reach Ollama
  - host.docker.internal
  - reverse-proxy subpath (/openwebui)
  - data not persisting after recreate/update
Updated docs/getting-started/index.md with an Unraid section link.
Updated docs/getting-started/quick-start/index.mdx with a direct Unraid guide link.
Updated docs/troubleshooting/connection-error.mdx to cross-link to the Unraid guide.

Validation

npm run prettier:check ✅
npm run mdx-check ✅
npm run build ✅ (build succeeds; existing unrelated broken-anchor warnings remain)

Screenshots

No UI/app behavior changes; docs-only update.

_{🔄 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/1126 **Author:** [@idanzairi302](https://github.com/idanzairi302) **Created:** 3/4/2026 **Status:** ✅ Merged **Merged:** 3/4/2026 **Merged by:** [@Classic298](https://github.com/Classic298) **Base:** `main` ← **Head:** `codex/unraid-beginner-safe-docs` --- ### 📝 Commits (2) - [`fcae985`](https://github.com/open-webui/docs/commit/fcae9855702b20549916f6e089b3f22768eda5dc) docs: add beginner-safe Unraid deployment guide - [`fafb49f`](https://github.com/open-webui/docs/commit/fafb49f9d8ce3c2627ee84a2148d50eb49ef57c5) docs: move Unraid guide to tutorials/integrations ### 📊 Changes **1 file changed** (+143 additions, -0 deletions) <details> <summary>View changed files</summary> ➕ `docs/tutorials/integrations/unraid.md` (+143 -0) </details> ### 📄 Description ## Summary Adds a beginner-safe Unraid guide to the docs site and links it from Getting Started and troubleshooting entry points. This PR moves the work that was previously submitted to `open-webui/open-webui` into the correct repository (`open-webui/docs`) per maintainer guidance. ## Changes - Added new page: `docs/getting-started/unraid.md` - step-by-step Unraid Docker template config - persistent volume guidance - safe upgrade workflow - troubleshooting for: - cannot reach Ollama - `host.docker.internal` - reverse-proxy subpath (`/openwebui`) - data not persisting after recreate/update - Updated `docs/getting-started/index.md` with an Unraid section link. - Updated `docs/getting-started/quick-start/index.mdx` with a direct Unraid guide link. - Updated `docs/troubleshooting/connection-error.mdx` to cross-link to the Unraid guide. ## Validation - `npm run prettier:check` ✅ - `npm run mdx-check` ✅ - `npm run build` ✅ (build succeeds; existing unrelated broken-anchor warnings remain) ## Screenshots No UI/app behavior changes; docs-only update. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

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