Binboi Logo
Dashboard
Binboi Docs/Getting Started/Introduction

Introduction

Binboi is a tunneling tool that exposes your local services to the internet via secure public URLs. Think of it as your own private ngrok — fast, TLS-encrypted, and under your control.

What is Binboi?

When you run a web server locally on localhost:3000, only your machine can reach it. Binboi creates an encrypted tunnel from a public URL on the internet to your local port, so teammates, external APIs, and webhook providers can all reach your service instantly — no firewall changes, no static IP, no deployment required.

Binboi is designed for developers who want:

  • HTTPS by default — every tunnel gets a valid TLS certificate automatically
  • Team access — share stable subdomains with your team during development
  • Webhook debugging — inspect and replay incoming HTTP requests in real time
  • TCP tunnels — forward databases, SSH, and any non-HTTP service

How It Works

code
Your Machine                 Binboi Server              Public Internet
─────────────               ─────────────────          ─────────────────
localhost:3000  ──tunnel──▶  api.binboi.com      ◀────  https://abc.binboi.com
  1. The Binboi CLI opens a persistent, encrypted connection to the Binboi control plane.
  2. The server assigns a public subdomain (e.g. abc.binboi.com) to that connection.
  3. Incoming HTTPS requests are forwarded through the tunnel to your local port.
  4. Responses travel back through the same tunnel to the caller.

The tunnel uses a multiplexed TCP connection under the hood, so there is no polling — latency is near real-time.

Key Features

  • HTTP & HTTPS tunnels — expose any HTTP service with automatic TLS termination
  • TCP tunnels — forward raw TCP traffic for databases, SSH, game servers, and more
  • Request inspector — view headers, bodies, and response codes for every request
  • Webhook replayer — re-send any captured request without triggering the original source
  • Custom subdomains — use reserved names like myapp.binboi.com across sessions (Pro+)
  • Multiple regions — route traffic through the region closest to your users
  • CLI + SDKs — first-class support for JavaScript, Python, and Rust

Self-Hosted vs. Managed

Binboi is offered as a managed service at binboi.com. The control plane runs in our Frankfurt region, and your tunnel traffic stays end-to-end TLS encrypted. Self-hosting (running your own control plane) is on the roadmap — see the self-hosting guide.

Next Steps

Edit this page on GitHub