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.