From c1d170e13d229759f6de4a8b200f757d4543e30d Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Wed, 24 Dec 2025 21:56:21 +0000 Subject: [PATCH] docs: note tailscale gmail path behavior --- docs/configuration.md | 5 ++++- docs/gmail-pubsub.md | 5 +++++ 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/configuration.md b/docs/configuration.md index d5995e756..bba03e23f 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -375,13 +375,16 @@ Gmail helper config (used by `clawdis hooks gmail setup` / `run`): includeBody: true, maxBytes: 20000, renewEveryMinutes: 720, - serve: { bind: "127.0.0.1", port: 8788, path: "/gmail-pubsub" }, + serve: { bind: "127.0.0.1", port: 8788, path: "/" }, tailscale: { mode: "funnel", path: "/gmail-pubsub" }, } } } ``` +Note: when `tailscale.mode` is on, Clawdis defaults `serve.path` to `/` so +Tailscale can proxy `/gmail-pubsub` correctly (it strips the set-path prefix). + ### `canvasHost` (LAN/tailnet Canvas file server + live reload) The Gateway serves a directory of HTML/CSS/JS over HTTP so iOS/Android nodes can simply `canvas.navigate` to it. diff --git a/docs/gmail-pubsub.md b/docs/gmail-pubsub.md index 57e867e6b..6a90c7663 100644 --- a/docs/gmail-pubsub.md +++ b/docs/gmail-pubsub.md @@ -46,6 +46,11 @@ Defaults: - Writes `hooks.gmail` config for `clawdis hooks gmail run`. - Enables the Gmail hook preset (`hooks.presets: ["gmail"]`). +Path note: when `tailscale.mode` is enabled, Clawdis automatically sets +`hooks.gmail.serve.path` to `/` and keeps the public path at +`hooks.gmail.tailscale.path` (default `/gmail-pubsub`) because Tailscale +strips the set-path prefix before proxying. + Want a custom endpoint? Use `--push-endpoint ` or `--tailscale off`. Platform note: on macOS the wizard installs `gcloud`, `gogcli`, and `tailscale`