From bf04f2d163e34df3be98ce1355e092b420feb03a Mon Sep 17 00:00:00 2001
From: jtbx <ccc@jtbx.de>
Date: Fri, 4 Sep 2026 20:59:20 +0200
Subject: [PATCH] Docs: Add dokuwiki upgrade guide

---
 docs/guides/update-dokuwiki.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 docs/guides/update-dokuwiki.md

diff --git a/docs/guides/update-dokuwiki.md b/docs/guides/update-dokuwiki.md
new file mode 100644
index 0000000..02d5942
--- /dev/null
+++ b/docs/guides/update-dokuwiki.md
@@ -0,0 +1,27 @@
+---
+title: Updating Dokuwiki
+---
+
+!!! success "Goal"
+
+    How to update our wiki (<https://wiki.hamburg.ccc.de>) to the latest version
+
+## 1. Create a Snaphot
+
+Go to the Chaosknoten Proxmox UI and create a snapshot of the `wiki` VM: <https://chaosknoten.hamburg.ccc.de:8006/#v1:0:=qemu%2F127:4:::::29::>
+
+## 2. Update Plugins
+
+- Go to the wiki's extension manager: <https://wiki.hamburg.ccc.de/start?do=admin&page=extension> or go to Admin > Extension Manager
+- Update the "DokuWiki Upgrade Plugin" (if it has updates)
+- Update other plugins while we're here already
+
+## 3. Update Dokuwiki
+
+- Go to the Wiki Upgrade: <https://wiki.hamburg.ccc.de/start?do=admin&page=upgrade> or go to Admin > Wiki Upgrade
+- Click through the steps. Note: Disabling any plugins before the upgrade was not necessary in the past.
+
+## Closing Up
+
+Log out and back in again to verify that the Keycloak connection still works.
+Maybe browse some pages as check if anything is obviously broken.