Tunnel Providers

Tunnels let you expose your local gateway to the internet, enabling webhooks from services like Telegram, Discord, and Slack.

Supported providers

Provider	Command	Notes
Cloudflare	cloudflared	Free, stable, recommended
ngrok	ngrok	Free tier available
Tailscale	tailscale funnel	Requires Tailscale account
Custom	Any command	Bring your own tunnel

Configuration

{
  "tunnel": {
    "provider": "cloudflared",
    "port": 3000
  }
}

Cloudflare Tunnel (recommended)

Install cloudflared and Human handles the rest:

brew install cloudflared     # macOS
# or download from https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/

human gateway --tunnel cloudflared

ngrok

human gateway --tunnel ngrok

Requires ngrok in your PATH. Set your auth token via NGROK_AUTHTOKEN or in the config.

Tailscale Funnel

human gateway --tunnel tailscale

Requires Tailscale to be running with Funnel enabled on your account.

Custom tunnel

{
  "tunnel": {
    "provider": "custom",
    "command": "my-tunnel --port {port}",
    "url_pattern": "https://{subdomain}.my-tunnel.dev"
  }
}

The {port} placeholder is replaced with the gateway port. Human parses stdout for the public URL.