From 1d5f5e16e817f716f3efcd09167fe1952091a457 Mon Sep 17 00:00:00 2001
From: Alex Lebens <alexanderlebens@gmail.com>
Date: Sat, 16 May 2026 19:49:41 -0500
Subject: [PATCH] feat: add guide for Komodo

---
 .../docs/guides/Komodo/update-hosts.mdx       | 68 +++++++++++++++++++
 1 file changed, 68 insertions(+)
 create mode 100644 src/content/docs/guides/Komodo/update-hosts.mdx

diff --git a/src/content/docs/guides/Komodo/update-hosts.mdx b/src/content/docs/guides/Komodo/update-hosts.mdx
new file mode 100644
index 0000000..979515b
--- /dev/null
+++ b/src/content/docs/guides/Komodo/update-hosts.mdx
@@ -0,0 +1,68 @@
+---
+title: Update Komodo Hosts
+description: Steps followed to update the Periphery Agents on Komodo managed hosts.
+hero:
+  tagline: Steps followed to update the Periphery Agents on Komodo managed hosts.
+  image:
+    file: https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/komodo.webp
+---
+
+import { Aside } from '@astrojs/starlight/components';
+import { Steps } from '@astrojs/starlight/components';
+
+<Aside type="tip">Find the latest documentation from Komodo [here](https://komo.do/docs/intro).</Aside>
+<Aside type="tip">Find the local Application documentation [here](https://docs.alexlebens.dev/applications/komodo/).</Aside>
+
+# Systemd hosts
+
+These hosts are on the same network as Komodo and have direct access. For simplicity, they run as a [systemd](https://systemd.io/) service.
+
+SSH to the host and run the following command. This command is repeatable and non-destructive and will update to the latest version.
+````bash
+curl -sSL https://raw.githubusercontent.com/moghtech/komodo/main/scripts/setup-periphery.py | python3 - \
+  --core-address="https://komodo.alexlebens.net"
+````
+
+# Docker hosts
+
+These hosts are not on the network and need some kind of VPN connection, such as [Tailscale](https://tailscale.com/). Because of this requirement it becomes simpler to use containers and [Docker networks](https://docs.docker.com/engine/network/).
+
+The hosts should have their [compose](https://docs.docker.com/compose/) files defined in the [infrastructure repository](https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/hosts). Therefore, [Renovate](https://gitea.alexlebens.dev/alexlebens/infrastructure/actions?workflow=renovate.yaml&actor=0&status=0) will make updates to those files.
+
+<Steps>
+1. SSH to the host and switch user to root.
+    ````bash
+    ssh <hostname>
+    ````
+    
+2. Change directory to where the local git folder is. This can vary per host, but the default should be in the /opt/compose folder.
+    ````bash
+    cd /opt/compose/infrastructure
+    ````
+
+3. Pull the latest changes.
+    ````bash
+    git pull
+    ````
+
+4. Change directory to the host and Komodo app.
+    ````bash
+    cd /opt/compose/infrastructure/hosts/<host>/komodo-periphery
+    ````
+
+5. Bring down the current stack.
+    ````bash
+    docker compose down
+    ````
+
+5. Bring down the stack back up. This should pull the latest image.
+    ````bash
+    docker compose up -d
+    ````
+
+6. Verify updates on the Komodo servers page.
+    ````
+    [https://komodo.alexlebens.net/servers](https://komodo.alexlebens.net/servers)
+    ````
+</Steps>
+