From fafb49f9d8ce3c2627ee84a2148d50eb49ef57c5 Mon Sep 17 00:00:00 2001 From: Idan Zairi Date: Wed, 4 Mar 2026 12:30:16 +0200 Subject: [PATCH] docs: move Unraid guide to tutorials/integrations --- docs/getting-started/index.md | 6 ----- docs/getting-started/quick-start/index.mdx | 2 -- docs/troubleshooting/connection-error.mdx | 1 - .../integrations}/unraid.md | 22 +++++++++++++------ 4 files changed, 15 insertions(+), 16 deletions(-) rename docs/{getting-started => tutorials/integrations}/unraid.md (81%) diff --git a/docs/getting-started/index.md b/docs/getting-started/index.md index 6bbc6500..aeb54f96 100644 --- a/docs/getting-started/index.md +++ b/docs/getting-started/index.md @@ -16,12 +16,6 @@ Get up and running quickly with our [Quick Start Guide](/getting-started/quick-s --- -## 🧰 Unraid Guide - -Running on Unraid? Use our beginner-safe [Open WebUI on Unraid](/getting-started/unraid) guide for Docker template setup, persistent volumes, upgrades, and reverse-proxy troubleshooting. - ---- - ## 🛠️ Advanced Topics Take a deeper dive into configurations and development tips in our [Advanced Topics Guide](/getting-started/advanced-topics). diff --git a/docs/getting-started/quick-start/index.mdx b/docs/getting-started/quick-start/index.mdx index 61349d97..a7e80807 100644 --- a/docs/getting-started/quick-start/index.mdx +++ b/docs/getting-started/quick-start/index.mdx @@ -41,8 +41,6 @@ Choose your preferred installation method below: - **Python:** Suitable for low-resource environments or those wanting a manual setup - **Kubernetes:** Ideal for enterprise deployments that require scaling and orchestration -Using Unraid? See the dedicated [Open WebUI on Unraid (Beginner-Safe)](/getting-started/unraid) guide. - diff --git a/docs/troubleshooting/connection-error.mdx b/docs/troubleshooting/connection-error.mdx index 0e274835..1ac2e62d 100644 --- a/docs/troubleshooting/connection-error.mdx +++ b/docs/troubleshooting/connection-error.mdx @@ -70,7 +70,6 @@ The `CORS_ALLOW_ORIGIN` setting is crucial for WebSocket functionality. If you s ### Reverse Proxy / SSL/TLS Configuration For reverse proxy and TLS setups, check our [tutorials here](/reference/https). -If you are running Unraid, use the [Open WebUI on Unraid (Beginner-Safe)](/getting-started/unraid) deployment and troubleshooting guide. ### WebSocket Troubleshooting diff --git a/docs/getting-started/unraid.md b/docs/tutorials/integrations/unraid.md similarity index 81% rename from docs/getting-started/unraid.md rename to docs/tutorials/integrations/unraid.md index ef19f2d4..bedd9c53 100644 --- a/docs/getting-started/unraid.md +++ b/docs/tutorials/integrations/unraid.md @@ -1,8 +1,14 @@ --- -sidebar_position: 3 -title: "Unraid (Beginner-Safe)" +sidebar_position: 34 +title: "Unraid Deployment (Beginner-Safe)" --- +:::warning + +This tutorial is a community contribution and is not supported by the Open WebUI team. It serves only as a demonstration on how to customize Open WebUI for your specific use case. Want to contribute? Check out the [contributing tutorial](/tutorials/tips/contributing-tutorial). + +::: + # Open WebUI on Unraid (Beginner-Safe) This guide is for first-time Unraid users who want a stable Docker deployment with persistent data and safe upgrades. @@ -73,12 +79,13 @@ Choose one setup. 1. Start the container. 2. Open `http://:3000`. 3. Complete initial admin setup. -4. Open **Admin Settings > Connections > Ollama** and verify the endpoint. +4. Open **Settings > Admin Settings > Connections** and verify the Ollama endpoint. 5. Confirm models appear in the model selector. ## 4. Persistent Volume Notes - Open WebUI state is stored in `/app/backend/data`. +- Set a fixed `WEBUI_SECRET_KEY` in your Unraid template and keep it the same across recreates to avoid unnecessary session invalidation. - Keep host mapping consistent across updates/recreates. - Use a directory mapping, not a file mapping. - If persistence fails, check folder permissions for `/mnt/user/appdata/open-webui`. @@ -86,10 +93,11 @@ Choose one setup. ## 5. Upgrade Steps (Safe Workflow) 1. Back up `/mnt/user/appdata/open-webui`. -2. Update/pull your Open WebUI image tag. -3. Recreate using the same template and same `/app/backend/data` mapping. -4. Verify chats/settings are intact. -5. If needed, roll back to the previous image and restore backup. +2. Ensure your template keeps the same `WEBUI_SECRET_KEY`. +3. Update/pull your Open WebUI image tag. +4. Recreate using the same template and the same `/app/backend/data` mapping. +5. Verify chats/settings are intact. +6. If needed, roll back to the previous image and restore backup. For broader update options, see [Updating Open WebUI](/getting-started/updating).