Overview

Welcome to the Localtonet documentation. This comprehensive resource offers easy-to-understand answers to all of your questions. Localtonet is a powerful and user-friendly tool that enables you to quickly and easily expose your local or intranet services to the internet.

To get started with Localtonet, simply download the appropriate version for your operating system or use the Android app. Once you have installed Localtonet, you can use it to create HTTP/s, UDP, TCP, and UDP/TCP tunnels to securely and reliably connect to your local or intranet services from anywhere in the world.

Whether you are a developer, a business owner, or just someone looking for an easier way to access your local services remotely, Localtonet is the perfect solution. With its easy installation, simple interface, and powerful features, it's no wonder that Localtonet is quickly becoming the go-to choice for people looking to expose their local services to the internet.

Download

Supported Tunnels

Linux packages

Installable DEB and RPM packages for x64 and ARM64. Requires systemd 247 or newer and OpenSSL 3, such as Debian 12, Ubuntu 22.04+ or RHEL 9.

Debian / Ubuntu · x64
Setup instructions

1. Install the downloaded package. Open a terminal in the directory containing localtonet-linux-x64.deb.
```
sudo apt install ./localtonet-linux-x64.deb
```
2. Set your AuthToken. Edit /etc/localtonet/auth-token as root and replace DUMMY_AUTH_TOKEN with your token on a single line. Then protect the file and check the configuration:
```
sudo chmod 600 /etc/localtonet/auth-token
sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. Start the service. Once the configuration check succeeds:
```
sudo systemctl enable --now localtonet.service
sudo journalctl -u localtonet.service
```
For upgrades, install the new package and run sudo systemctl restart localtonet. Your configuration is preserved.
Debian / Ubuntu · ARM64
Setup instructions

1. Install the downloaded package. Open a terminal in the directory containing localtonet-linux-arm64.deb.
```
sudo apt install ./localtonet-linux-arm64.deb
```
2. Set your AuthToken. Edit /etc/localtonet/auth-token as root and replace DUMMY_AUTH_TOKEN with your token on a single line. Then protect the file and check the configuration:
```
sudo chmod 600 /etc/localtonet/auth-token
sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. Start the service. Once the configuration check succeeds:
```
sudo systemctl enable --now localtonet.service
sudo journalctl -u localtonet.service
```
For upgrades, install the new package and run sudo systemctl restart localtonet. Your configuration is preserved.
Fedora / RHEL · x64
Setup instructions

1. Install the downloaded package. Open a terminal in the directory containing localtonet-linux-x64.rpm.
```
sudo dnf install ./localtonet-linux-x64.rpm
```
2. Set your AuthToken. Edit /etc/localtonet/auth-token as root and replace DUMMY_AUTH_TOKEN with your token on a single line. Then protect the file and check the configuration:
```
sudo chmod 600 /etc/localtonet/auth-token
sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. Start the service. Once the configuration check succeeds:
```
sudo systemctl enable --now localtonet.service
sudo journalctl -u localtonet.service
```
For upgrades, install the new package and run sudo systemctl restart localtonet. Your configuration is preserved.
Fedora / RHEL · ARM64
Setup instructions

1. Install the downloaded package. Open a terminal in the directory containing localtonet-linux-arm64.rpm.
```
sudo dnf install ./localtonet-linux-arm64.rpm
```
2. Set your AuthToken. Edit /etc/localtonet/auth-token as root and replace DUMMY_AUTH_TOKEN with your token on a single line. Then protect the file and check the configuration:
```
sudo chmod 600 /etc/localtonet/auth-token
sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. Start the service. Once the configuration check succeeds:
```
sudo systemctl enable --now localtonet.service
sudo journalctl -u localtonet.service
```
For upgrades, install the new package and run sudo systemctl restart localtonet. Your configuration is preserved.

The included systemd service is configured for tunnels. VPN requires a separate service configuration with the necessary privileges.

Termux for Android

Run the console client in Termux on an ARM64 Android device. The package manager installs the required .NET runtime automatically. ASP.NET Core is not required.

Install the ZIP package

curl -fLO https://localtonet.com/download/localtonet-termux.zip
unzip -o localtonet-termux.zip
pkg install ./localtonet.deb
localtonet --authtoken <YOUR_TOKEN>

The direct DEB download can be installed with pkg install ./localtonet-termux.deb. An internet connection is required to install missing dependencies.

OpenWrt

Experimental. Choose IPK for OpenWrt 24.10 or APK v3 for 25.12+. These APK files are OpenWrt packages, not Android apps.

x64 and ARM64 only. The package architecture must match your firmware; check the package's setup instructions and opkg print-architecture or apk --print-arch. MIPS, MIPSEL and ARMv7 are not supported by these packages. Check available storage and RAM before installing.

OpenWrt 24.10 · x64 · IPK
Setup instructions

1. Install the downloaded package. Open a terminal in the directory containing localtonet-openwrt-24.10-x64.ipk.

Run these commands on the router as root. Confirm that the package architecture matches your firmware before installing.
```
opkg print-architecture
opkg update
opkg install ./localtonet-openwrt-24.10-x64.ipk
```
2. Set your AuthToken. Edit /etc/localtonet/auth-token as root and replace DUMMY_AUTH_TOKEN with your token on a single line. Then protect the file and check the configuration:
```
chmod 600 /etc/localtonet/auth-token
localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. Start the service. Once the configuration check succeeds:
```
uci set localtonet.main.enabled='1'
uci commit localtonet
/etc/init.d/localtonet enable
/etc/init.d/localtonet restart
logread -e localtonet
```
For upgrades, install the new package and run /etc/init.d/localtonet restart. Your configuration is preserved.
OpenWrt 24.10 · ARM64 · IPK
Setup instructions

1. Install the downloaded package. Open a terminal in the directory containing localtonet-openwrt-24.10-arm64.ipk.

Run these commands on the router as root. Confirm that the package architecture matches your firmware before installing.
```
opkg print-architecture
opkg update
opkg install ./localtonet-openwrt-24.10-arm64.ipk
```
2. Set your AuthToken. Edit /etc/localtonet/auth-token as root and replace DUMMY_AUTH_TOKEN with your token on a single line. Then protect the file and check the configuration:
```
chmod 600 /etc/localtonet/auth-token
localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. Start the service. Once the configuration check succeeds:
```
uci set localtonet.main.enabled='1'
uci commit localtonet
/etc/init.d/localtonet enable
/etc/init.d/localtonet restart
logread -e localtonet
```
For upgrades, install the new package and run /etc/init.d/localtonet restart. Your configuration is preserved.
OpenWrt 25.12+ · x64 · APK v3
Setup instructions

1. Install the downloaded package. Open a terminal in the directory containing localtonet-openwrt-25.12-x64.apk.

Run these commands on the router as root. Confirm that the package architecture matches your firmware before installing.

This local APK package is unsigned, so installation requires --allow-untrusted.
```
apk --print-arch
apk update
apk add --allow-untrusted ./localtonet-openwrt-25.12-x64.apk
```
2. Set your AuthToken. Edit /etc/localtonet/auth-token as root and replace DUMMY_AUTH_TOKEN with your token on a single line. Then protect the file and check the configuration:
```
chmod 600 /etc/localtonet/auth-token
localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. Start the service. Once the configuration check succeeds:
```
uci set localtonet.main.enabled='1'
uci commit localtonet
/etc/init.d/localtonet enable
/etc/init.d/localtonet restart
logread -e localtonet
```
For upgrades, install the new package and run /etc/init.d/localtonet restart. Your configuration is preserved.
OpenWrt 25.12+ · ARM64 · APK v3
Setup instructions

1. Install the downloaded package. Open a terminal in the directory containing localtonet-openwrt-25.12-arm64.apk.

Run these commands on the router as root. Confirm that the package architecture matches your firmware before installing.

This local APK package is unsigned, so installation requires --allow-untrusted.
```
apk --print-arch
apk update
apk add --allow-untrusted ./localtonet-openwrt-25.12-arm64.apk
```
2. Set your AuthToken. Edit /etc/localtonet/auth-token as root and replace DUMMY_AUTH_TOKEN with your token on a single line. Then protect the file and check the configuration:
```
chmod 600 /etc/localtonet/auth-token
localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. Start the service. Once the configuration check succeeds:
```
uci set localtonet.main.enabled='1'
uci commit localtonet
/etc/init.d/localtonet enable
/etc/init.d/localtonet restart
logread -e localtonet
```
For upgrades, install the new package and run /etc/init.d/localtonet restart. Your configuration is preserved.

Read the setup instructions for your package before installing. Packages are unsigned; firmware compatibility, tunnels and VPN need validation on the intended device. Never force a mismatched architecture.

NAS & Home Assistant

Docker Compose templates for Synology Container Manager, QNAP Container Station and other Docker-capable NAS devices, plus a Home Assistant app template for OS / Supervised. AMD64 and ARM64.

These are setup templates, not SPK / QPKG installers or an official Home Assistant store listing. A matching Docker image must be available in the registry. Home Assistant Container / Core users can use the Compose template.

NAS / Home Assistant · templates

Set up your NAS or Home Assistant

Extract the ZIP and read README.txt.
For a NAS, copy nas/auth-token.example to nas/auth-token and enter your AuthToken. Keep this file private.
Check the image tag in nas/compose.yaml, then import it as a project or run docker compose up -d from the nas directory.
For Home Assistant OS / Supervised, follow the local app installation instructions in the README and enter the token in the app configuration.

The templates use Linux host networking for LAN access. They do not enable VPN privileges.