From 706cbe89ec21aacb6e8bc24e4621c8ca48acd1f1 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Fri, 9 Jan 2026 18:17:19 +0100
Subject: [PATCH] fix: align Hetzner docker guide with gateway runtime (#556)
 (thanks @Iamadig)

---
 CHANGELOG.md              |  1 +
 docs/docs.json            |  1 +
 docs/platforms/hetzner.md | 30 ++++++++++++++++++++++++------
 3 files changed, 26 insertions(+), 6 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 723771cf6..9a17019ef 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,7 @@
 - Node bridge: harden keepalive + heartbeat handling (TCP keepalive, better disconnects, and keepalive config tests). (#577) — thanks @steipete
 - Control UI: improve mobile responsiveness. (#558) — thanks @carlulsoe
 - CLI: add `sandbox list` and `sandbox recreate` commands for managing Docker sandbox containers after image/config updates. (#563) — thanks @pasogott
+- Docs: add Hetzner Docker VPS guide. (#556) — thanks @Iamadig
 - Providers: add Microsoft Teams provider with polling, attachments, and CLI send support. (#404) — thanks @onutc
 - Slack: honor reply tags + replyToMode while keeping threaded replies in-thread. (#574) — thanks @bolismauro
 - Discord: avoid category parent overrides for channel allowlists and refactor thread context helpers. (#588) — thanks @steipete
diff --git a/docs/docs.json b/docs/docs.json
index ac0f48b00..0de50a2bd 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -679,6 +679,7 @@
           "platforms/android",
           "platforms/windows",
           "platforms/linux",
+          "platforms/hetzner",
           "platforms/exe-dev"
         ]
       },
diff --git a/docs/platforms/hetzner.md b/docs/platforms/hetzner.md
index 3bdb9f688..254a625fc 100644
--- a/docs/platforms/hetzner.md
+++ b/docs/platforms/hetzner.md
@@ -112,7 +112,9 @@ Create `.env` in the repository root.
 ```bash
 CLAWDBOT_IMAGE=clawdbot:latest
 CLAWDBOT_GATEWAY_TOKEN=change-me-now
+CLAWDBOT_GATEWAY_BIND=lan
 CLAWDBOT_GATEWAY_PORT=18789
+CLAWDBOT_BRIDGE_PORT=18790
 
 CLAWDBOT_CONFIG_DIR=/root/.clawdbot
 CLAWDBOT_WORKSPACE_DIR=/root/clawd
@@ -133,12 +135,17 @@ Create or update `docker-compose.yml`.
 services:
   clawdbot-gateway:
     image: ${CLAWDBOT_IMAGE}
+    build: .
     restart: unless-stopped
     env_file:
       - .env
     environment:
+      - HOME=/home/node
       - NODE_ENV=production
       - TERM=xterm-256color
+      - CLAWDBOT_GATEWAY_BIND=${CLAWDBOT_GATEWAY_BIND}
+      - CLAWDBOT_GATEWAY_PORT=${CLAWDBOT_GATEWAY_PORT}
+      - CLAWDBOT_BRIDGE_PORT=${CLAWDBOT_BRIDGE_PORT}
       - CLAWDBOT_GATEWAY_TOKEN=${CLAWDBOT_GATEWAY_TOKEN}
       - GOG_KEYRING_PASSWORD=${GOG_KEYRING_PASSWORD}
       - XDG_CONFIG_HOME=${XDG_CONFIG_HOME}
@@ -148,7 +155,18 @@ services:
       - ${CLAWDBOT_WORKSPACE_DIR}:/home/node/clawd
     ports:
       - "${CLAWDBOT_GATEWAY_PORT}:18789"
+      - "${CLAWDBOT_BRIDGE_PORT}:18790"
       - "18793:18793"
+    command:
+      [
+        "node",
+        "dist/index.js",
+        "gateway-daemon",
+        "--bind",
+        "${CLAWDBOT_GATEWAY_BIND}",
+        "--port",
+        "${CLAWDBOT_GATEWAY_PORT}"
+      ]
 ```
 
 ---
@@ -210,16 +228,16 @@ CMD ["node","dist/index.js"]
 ## 8) Build and launch
 
 ```bash
-docker compose build clawdbot-gateway
-docker compose up -d
+docker compose build
+docker compose up -d clawdbot-gateway
 ```
 
 Verify binaries:
 
 ```bash
-docker exec clawdbot-clawdbot-gateway-1 which gog
-docker exec clawdbot-clawdbot-gateway-1 which goplaces
-docker exec clawdbot-clawdbot-gateway-1 which wacli
+docker compose exec clawdbot-gateway which gog
+docker compose exec clawdbot-gateway which goplaces
+docker compose exec clawdbot-gateway which wacli
 ```
 
 Expected output:
@@ -235,7 +253,7 @@ Expected output:
 ## 9) Verify Gateway
 
 ```bash
-docker logs -f clawdbot-clawdbot-gateway-1
+docker compose logs -f clawdbot-gateway
 ```
 
 Success: