Run your own relay

Free & self-hosted — your server, your bandwidth. Standalone or federated with your account.

Your relay host

Type your relay's public hostname — every command below updates to match.

The relay is a single static binary (the dashboard is embedded). It's the rendezvous exit devices dial into and the SOCKS5 ingress your agents use. Run it anywhere with a public IP.

1 Download the relay

Linux · x86-64 ↓ Linux · arm64 ↓ macOS · Apple Silicon ↓ Windows · x86-64 ↓

2 Start it

Pick how devices & consumers are authenticated:

You issue the tokens. Simplest: a static device list (label:connect-token:access-token).

For real accounts + the dashboard, set DATABASE_URL=postgres://… instead of a static list — the relay self-migrates.

Keep your HumanProxy account & dashboard, but route through this relay. Start it with our federation public key, then in the dashboard hit a device → “Own relay” to mint a signed token this relay trusts.

The public key above is fetched live from this relay. No database needed — tokens are verified by signature.

3 Expose it

Put TLS in front for wss:// (any reverse proxy — Caddy/Traefik/nginx), and open the SOCKS port. Point {{HOST}}'s DNS at your server.

4 Connect an exit device

Run the exit client on a phone/laptop/home box (the desktop app, the mobile app, or the hpx CLI), pointing at your relay:

5 Route your automation

Point any SOCKS5 client (Playwright, Puppeteer, curl, your agent) at your relay's ingress:

Full integration recipes (Playwright, Puppeteer, Selenium, LLM agents): Route your automation →