Networking
Understand the harness, webhook, and companion network boundaries.
GlinkBot separates its network surfaces by trust level.
| Surface | Default bind | Purpose |
|---|---|---|
| Harness | 127.0.0.1:8799 (every private address with serve --lan) | Full app API and event stream |
| Webhook receiver | 127.0.0.1:8800 | Health and secret hook endpoints only |
| Companion sidecar | 0.0.0.0:8810 when enabled | Paired-device, token-authenticated allowlist |
| Companion control | 127.0.0.1:8811 | Pairing and device administration |
Remote access
Never forward the harness port yourself. A self-hosted server is reached through one of openmausbot serve's ways in:
--public-url https://…: your own cloudflared tunnel, Caddy or nginx in front;--domain HOST: a managed Caddy that gets the certificate;--tailscale: your tailnet, with Tailscale's HTTPS when the tailnet has certificates turned on, otherwise plain http on this machine's own tailnet address;--lan: this network only, plain http. It listens on every address, but answers only connections whose two ends are both private;--tunnel: a free GlinkBot web address.
Each prints one pairing link; paste it into the desktop app under + → Connect to a server. The app accepts plain http only on private networks: LAN addresses, Tailscale's 100.64/10 and *.ts.net, and *.local.
A loopback request counts as the owner only when it really comes from this machine; a LAN client that writes Host: 127.0.0.1 is still a stranger. For webhook delivery, proxy only the dedicated webhook receiver. Never forward the main harness port to the public internet.
Port overrides
Source and advanced deployments can change documented ports with the relevant environment settings. When the default harness port is occupied, packaged builds may fall back to another local port and communicate the selected address internally.
Custom domain
A custom domain must point to a host you operate with working TLS and authenticated remote access. Configure those before using a domain in the app. GlinkBot does not provision a managed account or public tunnel automatically. Keep local unauthenticated ports private.
GlinkBot documentation, reviewed for the 0.0.4 codebase. Public download availability can differ. Licenses and acknowledgments.