github-starred/open-webui
2
0
Fork 0
mirror of https://github.com/open-webui/open-webui.git synced 2026-05-07 03:18:23 -05:00
Code Issues 1.3k Packages Projects Releases 126 Wiki Activity

[PR #22208] [CLOSED] docs: add beginner-safe Unraid setup and troubleshooting guide #26550

New Issue
Closed
opened 2026-04-20 06:34:06 -05:00 by GiteaMirror · 0 comments
GiteaMirror commented 2026-04-20 06:34:06 -05:00
Owner
Copy Link

📋 Pull Request Information

Original PR: https://github.com/open-webui/open-webui/pull/22208
Author: @idanzairi302
Created: 3/4/2026
Status: ❌ Closed

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

📝 Commits (1)

  • 491d304 docs: add beginner-safe Unraid setup and troubleshooting

📊 Changes

4 files changed (+168 additions, -0 deletions)

View changed files

📝 README.md (+4 -0)
📝 TROUBLESHOOTING.md (+21 -0)
📝 docs/README.md (+7 -0)
➕ docs/unraid-beginner-safe.md (+136 -0)

📄 Description

Summary

Add a beginner-safe Unraid deployment guide for Open WebUI and wire it into docs navigation.

What Changed

  • Added new doc page: docs/unraid-beginner-safe.md
    • Step-by-step Unraid Docker container configuration
    • Persistent volume mapping guidance (/app/backend/data)
    • Safe upgrade workflow
    • Troubleshooting for:
      • cannot reach Ollama
      • host.docker.internal resolution
      • reverse-proxy subpath (/openwebui) issues
      • persistence/data reset issues
  • Updated docs/README.md with a docs index section including the new page.
  • Updated root README.md installation/troubleshooting sections to link to the new Unraid guide.
  • Added a dedicated reverse-proxy + persistent-volume troubleshooting section in TROUBLESHOOTING.md and linked to the Unraid guide.

Validation

  • npx prettier --check README.md TROUBLESHOOTING.md docs/README.md docs/unraid-beginner-safe.md ✅
  • npm run test:frontend ✅ (no tests found; command exits 0)
  • npm run build ✅
  • npm run check ❌ fails with pre-existing upstream type-check issues unrelated to this docs-only change.

Screenshots

No UI changes; screenshots are not applicable for this docs-only PR.

🔄 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/open-webui/pull/22208 **Author:** [@idanzairi302](https://github.com/idanzairi302) **Created:** 3/4/2026 **Status:** ❌ Closed **Base:** `main` ← **Head:** `codex/unraid-docs-beginner-safe` --- ### 📝 Commits (1) - [`491d304`](https://github.com/open-webui/open-webui/commit/491d304fc0f6f27dc317a1d5c4201860ea07b1f7) docs: add beginner-safe Unraid setup and troubleshooting ### 📊 Changes **4 files changed** (+168 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `README.md` (+4 -0) 📝 `TROUBLESHOOTING.md` (+21 -0) 📝 `docs/README.md` (+7 -0) ➕ `docs/unraid-beginner-safe.md` (+136 -0) </details> ### 📄 Description ## Summary Add a beginner-safe Unraid deployment guide for Open WebUI and wire it into docs navigation. ## What Changed - Added new doc page: `docs/unraid-beginner-safe.md` - Step-by-step Unraid Docker container configuration - Persistent volume mapping guidance (`/app/backend/data`) - Safe upgrade workflow - Troubleshooting for: - cannot reach Ollama - `host.docker.internal` resolution - reverse-proxy subpath (`/openwebui`) issues - persistence/data reset issues - Updated `docs/README.md` with a docs index section including the new page. - Updated root `README.md` installation/troubleshooting sections to link to the new Unraid guide. - Added a dedicated reverse-proxy + persistent-volume troubleshooting section in `TROUBLESHOOTING.md` and linked to the Unraid guide. ## Validation - `npx prettier --check README.md TROUBLESHOOTING.md docs/README.md docs/unraid-beginner-safe.md` ✅ - `npm run test:frontend` ✅ (no tests found; command exits 0) - `npm run build` ✅ - `npm run check` ❌ fails with pre-existing upstream type-check issues unrelated to this docs-only change. ## Screenshots No UI changes; screenshots are not applicable for this docs-only PR. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
GiteaMirror added the pull-request label 2026-04-20 06:34:06 -05:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
confirmed
confirmed issue
core
documentation
enhancement
good first issue
help wanted
non-core
pull-request
Mirrored from GitHub Pull Request
 python
question
testing wanted
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
GiteaMirror ninjasurge
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/open-webui#26550
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?