Documentation
Everything you need to self-host tunnl on your own infrastructure.
Getting Started
1
Install the server
Clone the repo, set your domain and JWT secret, run docker compose up -d. Configure DNS and TLS for wildcard subdomains.
2
Connect the CLI
Run curl -sSL https://tunnl.sh/install.sh | sh, then tunnl login --server https://your.domain.com.
3
Create your first tunnel
Run tunnl --port 3000. Get a public HTTPS subdomain. Send a test webhook. See it in the TUI inspector.
4
Verify persistent history
Restart the server. Open tunnl inspect. Your previous requests are still there. Replay one.
All Documentation
📦 Self-Hosted Install Guide
Prerequisites, Docker Compose setup, DNS, TLS, first tunnel, troubleshooting
💻 CLI Reference
Every subcommand, global flag, config file, and environment variable
⚙️ Configuration Reference
All server .env variables organized by category with defaults and examples
🤖 MCP Server Guide
Connect Claude Desktop, Cursor, or any MCP client to your tunnel traffic
📡 Protocol Specification
Wire protocol for developers building alternative clients
📝 Changelog
Release history, version notes, migration steps