diff --git a/docs/changelog.md b/docs/changelog.md
new file mode 100644
index 0000000..4ed2a35
--- /dev/null
+++ b/docs/changelog.md
@@ -0,0 +1,10 @@
+# Changelog
+
+## k3s update to v1.30 / 2024-08-30
+
+- Upgrade the cluster to Kubernetes version v1.30 (`v1.30.4`)
+
+## k3s update to v1.29 / 2024-08-30
+
+- Upgrade the cluster to Kubernetes version v1.29 (`v1.29.8`)
+- Upgrade the node OS (Rocky Linux 9, `dnf update -y`)
diff --git a/docs/k3s/upgrades.md b/docs/k3s/upgrades.md
new file mode 100644
index 0000000..1feb968
--- /dev/null
+++ b/docs/k3s/upgrades.md
@@ -0,0 +1,29 @@
+# k3s upgrades
+
+## Server
+
+```bash
+# manual
+curl -sfL https://get.k3s.io | INSTALL_K3S_CHANNEL=v1.29 sh -s -
+
+# with scripts
+# run as root
+# edit the version/channel
+editor ./k3s/install-k3s-server.sh
+# execute
+./k3s/install-k3s-server.sh
+```
+
+## Agent
+
+```bash
+# manual
+curl -sfL https://get.k3s.io | INSTALL_K3S_EXEC="agent" INSTALL_K3S_CHANNEL=v1.29 sh -s -
+
+# with scripts
+# run as root
+# edit the version/channel
+editor ./k3s/install-k3s-agent.sh
+# execute
+./k3s/install-k3s-agent.sh
+```