Update updating.mdx

2026-03-27 13:28:37 +07:00 · 2026-02-22 15:46:54 +01:00
parent 1b202316ee
commit 7a5b646e10
1 changed files with 36 additions and 60 deletions
--- a/docs/getting-started/updating.mdx
+++ b/docs/getting-started/updating.mdx
@@ -75,24 +75,10 @@ Without a persistent `WEBUI_SECRET_KEY`, a new key is generated each time the co

 By default the `:main` tag always points to the latest build. For production, pin a specific release:

-The original Watchtower project hasn't received updates in over two years and fails with Docker version 29.0.0 or newer due to API version incompatibility. Two maintained forks are now available: nicholas-fedor/watchtower and Marrrrrrrrry/watchtower, both compatible with Docker 29+.
-
-**Recommended: nicholas-fedor/watchtower fork**
-
-<Tabs>
-  <TabItem value="one-time" label="One-Time Update" default>
-
-Run Watchtower once to update all containers, then exit:
-
-```bash title="Terminal - One-Time Update"
-docker run --rm \
-  --volume /var/run/docker.sock:/var/run/docker.sock \
-  nickfedor/watchtower \
-  --run-once open-webui
 ```
-ghcr.io/open-webui/open-webui:v0.6.52
-ghcr.io/open-webui/open-webui:v0.6.52-cuda
-ghcr.io/open-webui/open-webui:v0.6.52-ollama
+ghcr.io/open-webui/open-webui:v0.8.4
+ghcr.io/open-webui/open-webui:v0.8.4-cuda
+ghcr.io/open-webui/open-webui:v0.8.4-ollama
 ```

 ### Rolling Back
@@ -101,10 +87,10 @@ If an update causes problems, pin the previous version:

 ```bash
 docker rm -f open-webui
-docker pull ghcr.io/open-webui/open-webui:v0.6.51
+docker pull ghcr.io/open-webui/open-webui:v0.8.3
 docker run -d -p 3000:8080 -v open-webui:/app/backend/data \
  -e WEBUI_SECRET_KEY="your-secret-key" \
-  --name open-webui ghcr.io/open-webui/open-webui:v0.6.51
+  --name open-webui ghcr.io/open-webui/open-webui:v0.8.3
 ```

 ---
@@ -123,54 +109,19 @@ Automated updates can break your deployment if a release includes breaking chang
 | **Web interface** | ❌ | ✅ | ❌ |
 | **Notifications** | ✅ | ✅ | ✅ |
 | **Docker 29+** | ✅ (forks) | ✅ | ✅ |
+| **Resource usage** | Low | Medium | Very Low |
 | **Best for** | Homelabs | Visual monitoring | Notification-only |

-### Watchtower
-
-```yaml title="docker-compose.yml"
-version: '3'
-services:
-  diun:
-    image: crazymax/diun:latest
-    container_name: diun
-    volumes:
-      - /var/run/docker.sock:/var/run/docker.sock:ro
-      - ./data:/data
-    environment:
-      - TZ=America/New_York
-      - LOG_LEVEL=info
-      - DIUN_WATCH_WORKERS=10
-      - DIUN_WATCH_SCHEDULE=0 */6 * * *  # Every 6 hours
-      - DIUN_PROVIDERS_DOCKER=true
-      - DIUN_NOTIF_MAIL_HOST=smtp.gmail.com
-      - DIUN_NOTIF_MAIL_PORT=587
-      - DIUN_NOTIF_MAIL_USERNAME=your-email@gmail.com
-      - DIUN_NOTIF_MAIL_PASSWORD=your-app-password
-      - DIUN_NOTIF_MAIL_FROM=your-email@gmail.com
-      - DIUN_NOTIF_MAIL_TO=your-email@gmail.com
-    restart: unless-stopped
-```
-
-For complete Diun documentation, visit https://crazymax.dev/diun/
-
-### Comparison: Which Tool Should You Use?
-
-| Feature | Watchtower (Fork) | WUD | Diun |
-|---------|------------------|-----|------|
-| **Automatic Updates** | ✅ Yes | ⚠️ Manual via UI | ❌ No |
-| **Web Interface** | ❌ No | ✅ Yes | ❌ No |
-| **Notifications** | ✅ Yes | ✅ Yes | ✅ Yes |
-| **Manual Control** | ⚠️ Limited | ✅ Full control | ✅ Full control |
-| **Resource Usage** | Low | Medium | Very Low |
-| **Docker 29+ Support** | ✅ Yes (forks) | ✅ Yes | ✅ Yes |
-| **Best For** | Set-and-forget homelabs | Visual monitoring + control | Notification-only workflows |
-
 :::tip Recommendation
 - **For homelabs/personal use:** nicholas-fedor/watchtower (automated)
 - **For managed environments:** WUD (visual + manual control)
 - **For production/critical systems:** Diun (notifications only) + manual updates
 :::

+### Watchtower
+
+The original Watchtower project hasn't received updates in over two years and fails with Docker version 29.0.0 or newer due to API version incompatibility. Two maintained forks are available: [nicholas-fedor/watchtower](https://watchtower.nickfedor.com/) and Marrrrrrrrry/watchtower, both compatible with Docker 29+.
+
 **One-time update:**
 ```bash
 docker run --rm \
@@ -193,7 +144,32 @@ Web UI for monitoring container updates and triggering them manually. See [WUD d

 ### Diun

-Notification-only — alerts you when updates are available (email, Slack, Discord, Telegram, etc.) without touching your containers. See [Diun documentation](https://crazymax.dev/diun/) for setup.
+Notification-only — alerts you when updates are available (email, Slack, Discord, Telegram, etc.) without touching your containers.
+
+```yaml title="docker-compose.yml"
+services:
+  diun:
+    image: crazymax/diun:latest
+    container_name: diun
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+      - ./data:/data
+    environment:
+      - TZ=America/New_York
+      - LOG_LEVEL=info
+      - DIUN_WATCH_WORKERS=10
+      - DIUN_WATCH_SCHEDULE=0 */6 * * *  # Every 6 hours
+      - DIUN_PROVIDERS_DOCKER=true
+      - DIUN_NOTIF_MAIL_HOST=smtp.gmail.com
+      - DIUN_NOTIF_MAIL_PORT=587
+      - DIUN_NOTIF_MAIL_USERNAME=your-email@gmail.com
+      - DIUN_NOTIF_MAIL_PASSWORD=your-app-password
+      - DIUN_NOTIF_MAIL_FROM=your-email@gmail.com
+      - DIUN_NOTIF_MAIL_TO=your-email@gmail.com
+    restart: unless-stopped
+```
+
+See [Diun documentation](https://crazymax.dev/diun/) for full setup and notification options.

 ---