How to Use Localtonet: Complete First Setup Guide (AuthToken and First Tunnel)
This guide explains how to start using Localtonet from scratch. You will learn how to create an account, generate an AuthToken, connect your device, and create your first tunnel to expose local services securely to the internet.
What You Will Learn
If you are new to Localtonet, this guide walks you through the complete onboarding process. By the end, your device will be linked, authenticated, and capable of exposing local applications through secure tunnels.
Video Tutorial
Step-by-Step Localtonet Setup
Create your Localtonet account
If you do not already have an account, register first and then sign in to access your dashboard.
- Create an account
- After registration, open your Dashboard .
Generate and copy your AuthToken
Localtonet uses an AuthToken to securely link each device with your account.
- Open the My Tokens page.
- Create a token and name it after your device.
- Copy the AuthToken value.
Install Localtonet on your device
Install the Localtonet application on the device that hosts your service.
- Open the Download page and choose your platform.
- Supported platforms include Windows, macOS, Linux, Android, Docker, and Zero-install SSH.
Authenticate using your AuthToken
After installation, authenticate the app so it can connect to your account.
- Desktop: Paste the token on first launch or run
localtonet --authtoken YOUR_TOKEN - Android: Paste the token inside the app and confirm
- Docker: Pass your token as described in the Docker docs
Once accepted, your device is linked and ready.
Create your first tunnel
After authentication, create a tunnel from your dashboard.
- Open the Dashboard
- Select the protocol (HTTP, TCP, UDP, etc.)
- Choose your device token
- Select region/server
- Enter local IP and port (example:
127.0.0.1:8080) - Create and start the tunnel
Localtonet generates a public URL for your service immediately.
What Happens After You Create a Tunnel?
Once your tunnel starts, Localtonet routes external traffic to your local environment through an encrypted connection. You can use the generated public URL for webhook testing, remote access, collaboration, or exposing internal services safely.
Localtonet does not move your application to the cloud. Your service continues running locally while Localtonet handles secure connectivity.
Next Steps
After completing your first tunnel, you can explore advanced workflows such as exposing databases, running game servers, publishing development environments, or enabling secure remote access.
For detailed tutorials and integration guides, visit: Localtonet Documentation
FAQ
What is an AuthToken in Localtonet?
An AuthToken securely associates your device with your Localtonet account and allows tunnel creation.
Do I need to keep Localtonet running?
Yes. The Localtonet application must remain active for tunnels to function.
Can I run Localtonet on multiple devices?
Yes. Each device can use its own AuthToken and be managed from your dashboard.
Start Using Localtonet Today
Create your first tunnel and expose local services securely in minutes.
Download Localtonet →