From ea6aea8532fca9dff5bf36fba42106c2175bd120 Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Sat, 3 Jan 2026 12:41:44 +0000 Subject: [PATCH] docs: warn about gmail watcher port conflict --- docs/configuration.md | 2 ++ docs/gmail-pubsub.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/docs/configuration.md b/docs/configuration.md index c2d1186bc..73ed4dba9 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -753,6 +753,8 @@ Gateway auto-start: - If `hooks.enabled=true` and `hooks.gmail.account` is set, the Gateway starts `gog gmail watch serve` on boot and auto-renews the watch. - Set `CLAWDIS_SKIP_GMAIL_WATCHER=1` to disable the auto-start (for manual runs). +- Avoid running a separate `gog gmail watch serve` alongside the Gateway; it will + fail with `listen tcp 127.0.0.1:8788: bind: address already in use`. Note: when `tailscale.mode` is on, Clawdis defaults `serve.path` to `/` so Tailscale can proxy `/gmail-pubsub` correctly (it strips the set-path prefix). diff --git a/docs/gmail-pubsub.md b/docs/gmail-pubsub.md index ab619b0fc..4f0216c08 100644 --- a/docs/gmail-pubsub.md +++ b/docs/gmail-pubsub.md @@ -60,6 +60,8 @@ Gateway auto-start (recommended): - When `hooks.enabled=true` and `hooks.gmail.account` is set, the Gateway starts `gog gmail watch serve` on boot and auto-renews the watch. - Set `CLAWDIS_SKIP_GMAIL_WATCHER=1` to opt out (useful if you run the daemon yourself). +- Do not run the manual daemon at the same time, or you will hit + `listen tcp 127.0.0.1:8788: bind: address already in use`. Manual daemon (starts `gog gmail watch serve` + auto-renew):