From f5e1057415f123d1c86bf9f884bd5b3dffef89e7 Mon Sep 17 00:00:00 2001 From: Jamie Taylor Date: Wed, 28 Jan 2026 18:10:59 +0000 Subject: [PATCH] docs(readme) - added info on host networking for users who have gateway exposed to loopback only (common tailscale setup) and how to pass allowed hosts as env vars in docker/source setups --- README.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index db19337..ba13d30 100644 --- a/README.md +++ b/README.md @@ -28,8 +28,10 @@ docker run -d \ ghcr.io/luccast/crabwalk:latest ``` -> Note: When running Crabwalk in Docker, the Clawdbot gateway typically runs on the *host*. +> Note: When running Crabwalk in Docker, the Moltbot gateway typically runs on the *host*. > Use `CLAWDBOT_URL=ws://host.docker.internal:18789` so the container can connect. +>If you're running Moltbot with `bind: loopback` and `tailscale serve` for secure tailnet-only access, you'll need to run the crabwalk container with host networking - replace `p:3000:3000` with `--network host` +>This allows the container to reach 127.0.0.1:18789 while maintaining the security benefits of loopback-only binding. Or with docker-compose: @@ -38,6 +40,8 @@ curl -O https://raw.githubusercontent.com/luccast/crabwalk/master/docker-compose CLAWDBOT_API_TOKEN=your-token CLAWDBOT_URL=ws://host.docker.internal:18789 docker-compose up -d ``` +> If gateway is `bind: loopback` only, you will need to edit the `docker-compose.yml` to add `network_mode: host` + ### From source ```bash @@ -74,6 +78,14 @@ Or copy it directly: export CLAWDBOT_API_TOKEN=$(python3 -c "import json,os; print(json.load(open(os.path.expanduser('~/.clawdbot/clawdbot.json')))['gateway']['auth']['token'])") ``` +## Accessing from a remote host + +If you are running this on a remote server and accessing it through a non-local browser, the default allowedHosts behaviour will prevent access to the web UI. + +If running in docker, you can pass the environment variable `ALLOWED_HOSTS` with a comma-separated list of hosts you wish to allow access to the crabwalk UI. + +If running from source, you can either pass `ALLOWED_HOSTS` as an env var at the command line, or use a .env file. + ## Stack TanStack Start, ReactFlow, Framer Motion, tRPC, TanStack DB