Getting Started

Welcome to TunnelBat! This guide will get you started with the TunnelBat client, giving you a secure mechanism for accessing your local services from any Internet connection.

1. Download TunnelBat

First, you'll need to download the TunnelBat client from for your Operating System here.

2. Signup for an account

You can signup for a Free account here

Alternatively, you can generate a signup link by running the following command:

1tunnelbat signup

3. Login to your account

After validating your e-mail, use the provisioned credentials to login with the following command:

1tunnelbat login

4. Start your local service

Start your local service as normal. As an example, we will use Python's http module:

1python3 -m http.server --bind 127.0.0.1

5. Open a tunnel!

Now, it's time to open a tunnel to the service:

1$ tunnelbat tls --target 127.0.0.1 --targetport 8000
22023/07/31 15:49:27 Designated server: https://rati.tunnelb.at
32023/07/31 15:49:27 client: Connecting to wss://rati.tunnelb.at:443
42023/07/31 15:49:27 client: Remote tunnel: tcp://abcdefghij.tunnelb.at:35508 -> tls://127.0.0.1:8000
52023/07/31 15:49:28 client: Latency: 40.63611ms

6. Connect to your tunnel

1$ curl https://abcdefghij.tunnelb.at:35508 -i
2HTTP/1.0 200 OK
3Server: SimpleHTTP/0.6 Python/3.10.6
4Date: Mon, 31 Jul 2023 19:51:57 GMT
5Content-type: text/html
6Content-Length: 0
7Last-Modified: Mon, 31 Jul 2023 19:48:32 GMT