docs: move Unraid guide to tutorials/integrations

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).

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.
-
 <Tabs>
   <TabItem value="docker" label="Docker">
     <Tabs>

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
 

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://<unraid-ip>: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).