|
1 | 1 | --- |
2 | | -sidebar_position: 3 |
3 | | -title: "Unraid (Beginner-Safe)" |
| 2 | +sidebar_position: 34 |
| 3 | +title: "Unraid Deployment (Beginner-Safe)" |
4 | 4 | --- |
5 | 5 |
|
| 6 | +:::warning |
| 7 | + |
| 8 | +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). |
| 9 | + |
| 10 | +::: |
| 11 | + |
6 | 12 | # Open WebUI on Unraid (Beginner-Safe) |
7 | 13 |
|
8 | 14 | This guide is for first-time Unraid users who want a stable Docker deployment with persistent data and safe upgrades. |
@@ -73,23 +79,25 @@ Choose one setup. |
73 | 79 | 1. Start the container. |
74 | 80 | 2. Open `http://<unraid-ip>:3000`. |
75 | 81 | 3. Complete initial admin setup. |
76 | | -4. Open **Admin Settings > Connections > Ollama** and verify the endpoint. |
| 82 | +4. Open **Settings > Admin Settings > Connections** and verify the Ollama endpoint. |
77 | 83 | 5. Confirm models appear in the model selector. |
78 | 84 |
|
79 | 85 | ## 4. Persistent Volume Notes |
80 | 86 |
|
81 | 87 | - Open WebUI state is stored in `/app/backend/data`. |
| 88 | +- Set a fixed `WEBUI_SECRET_KEY` in your Unraid template and keep it the same across recreates to avoid unnecessary session invalidation. |
82 | 89 | - Keep host mapping consistent across updates/recreates. |
83 | 90 | - Use a directory mapping, not a file mapping. |
84 | 91 | - If persistence fails, check folder permissions for `/mnt/user/appdata/open-webui`. |
85 | 92 |
|
86 | 93 | ## 5. Upgrade Steps (Safe Workflow) |
87 | 94 |
|
88 | 95 | 1. Back up `/mnt/user/appdata/open-webui`. |
89 | | -2. Update/pull your Open WebUI image tag. |
90 | | -3. Recreate using the same template and same `/app/backend/data` mapping. |
91 | | -4. Verify chats/settings are intact. |
92 | | -5. If needed, roll back to the previous image and restore backup. |
| 96 | +2. Ensure your template keeps the same `WEBUI_SECRET_KEY`. |
| 97 | +3. Update/pull your Open WebUI image tag. |
| 98 | +4. Recreate using the same template and the same `/app/backend/data` mapping. |
| 99 | +5. Verify chats/settings are intact. |
| 100 | +6. If needed, roll back to the previous image and restore backup. |
93 | 101 |
|
94 | 102 | For broader update options, see [Updating Open WebUI](/getting-started/updating). |
95 | 103 |
|
|
0 commit comments