Download Tunels Client

Secure tunnels to localhost. Available for all major platforms.

Current Version: v0.0.1
Quick Download

Detected Platform

Detecting...

Please wait
Download for Your System
Size: Calculating...

All Platforms

Choose your operating system and architecture

Verify Downloads
SHA-256 Checksums Available

Installation Guide

1. Download

Download the appropriate binary for your operating system and architecture.

2. Make Executable

On Unix systems, run:
chmod +x tunels-*

3. Run

Start your tunnel:
./tunels localhost:8000

Quick Start Guide

Basic Usage

The simplest way to start a tunnel to your local development server:

# Expose local web server on port 8000
./tunels -subdomain=myapp localhost:8000

# Your app is now available at:
# https://myapp.tunels.tech

Configuration File

Create a tunels.yml file for persistent configuration:

# tunels.yml
server_addr: tunels.tech:4443
trust_host_root_certs: false
auth_token: YOUR_AUTH_TOKEN
tunnels:
  web:
    subdomain: myapp
    proto:
      http: localhost:8000
  api:
    subdomain: myapi
    proto:
      http: localhost:3000

Then run with:

./tunels -config=tunels.yml start-all

Authentication

To use custom subdomains and advanced features, you'll need an auth token:

  1. Sign up for a Tunels account
  2. Go to your dashboard
  3. Generate an API token
  4. Add it to your configuration or command line
# With auth token
./tunels -authtoken=tnl_xxxxx -subdomain=custom localhost:8000

Common Use Cases

Webhook Development

Test webhooks from services like Stripe, GitHub, or Slack against your local development server.

Mobile App Testing

Connect mobile devices to your local API server for development and testing.

Demo & Client Preview

Share work-in-progress with clients or team members without deployment.

IoT Development

Connect IoT devices to your local server for testing and development.

Get started

Ready to start tunneling?

Sign up for a free account to get your auth token and unlock all features.

Create Free Account