Downloads

Download Localtonet

Choose your platform to download Localtonet and get started.

Choose your platform

Localtonet for Windows

Install the app or download a standalone Windows build.

Download

Start Localtonet with Your Token:
Open the app and paste your AuthToken when prompted, or start it from the command line.

Open Command Prompt or PowerShell in the folder containing localtonet, then run:

localtonet --authtoken <YOUR_TOKEN>

This stores the token locally. Once authenticated, Localtonet is ready to use.

Run Localtonet as a Windows Service (Automatic Startup):
Install Localtonet as a Windows Service so it starts automatically on every boot, keeps running after logout, and does not require an open terminal. Run Command Prompt or PowerShell as Administrator, then:

localtonet --install-service --authtoken <YOUR_TOKEN>

localtonet --start-service --authtoken <YOUR_TOKEN>

The service is visible in services.msc. Use --stop-service, --status-service, or --remove-service to manage it.

Documentation Windows Docs

Localtonet for macOS

Download for Intel or Apple Silicon, or install with Homebrew.

Download

Start Localtonet with Your Token:
Open the app and paste your AuthToken when prompted, or start it from the command line.

Open Terminal in the folder containing localtonet, then run:

localtonet --authtoken <YOUR_TOKEN>

This stores the token locally. Once authenticated, Localtonet is ready to use.

Download and Start with Homebrew:
Use our official tap to install Localtonet on MacOS

brew tap localtonet/tap

brew install localtonet

localtonet --version

About taps: Homebrew tap adds a third-party repository so you can install and update formulae from it.

Manual Download:
If you prefer a direct download, grab the archive for your Mac and install manually

curl -L https://localtonet.com/download/localtonet-osx-64.zip -o localtonet-osx-64.zip

unzip localtonet-osx-64.zip -d ~/localtonet

chmod 755 ~/localtonet/localtonet

#Optional: move into PATH (may require sudo) # sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet #Authenticate

localtonet --authtoken <YOUR_TOKEN>

Run Localtonet as a launchd Service (Automatic Startup):
Install Localtonet as a background service so it starts automatically on every boot, keeps running after logout, and does not require an open terminal. Requires administrator/root privileges:

sudo localtonet --install-service --authtoken <YOUR_TOKEN>

sudo localtonet --start-service --authtoken <YOUR_TOKEN>

The job is registered under ~/Library/LaunchAgents/. Use --stop-service, --status-service, or --remove-service to manage it.

Documentation macOS Docs

Localtonet for Linux

Choose a build for your architecture or use the quick installer.

Download

Start Localtonet with Your Token:
Open the app and paste your AuthToken when prompted, or start it from the command line.

Open Terminal in the folder containing localtonet, then run:

localtonet --authtoken <YOUR_TOKEN>

This stores the token locally. Once authenticated, Localtonet is ready to use.

Quick Install:
This one-liner detects your CPU/OS, downloads the correct build, and installs to /usr/local/bin/localtonet

curl -fsSL https://localtonet.com/install.sh | sh

Why it may ask for sudo: Installing to /usr/local/bin and managing system services typically require administrative privileges.

Manual Download:
If you prefer a direct download, grab the archive for your linux and install manually

wget https://localtonet.com/download/localtonet-linux-x64.zip

unzip localtonet-linux-x64.zip -d ~/localtonet

chmod 755 ~/localtonet/localtonet

#Optional: move to PATH (requires sudo) # sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet #Authenticate

~/localtonet/localtonet --authtoken <YOUR_TOKEN>

Run Localtonet as a systemd Service (Automatic Startup):
Install Localtonet as a systemd service so it starts automatically after every reboot, keeps running after logout, and does not require an open terminal. Root privileges are required (systemd is required; Termux is not supported, use the Android app instead):

sudo localtonet --install-service --authtoken <YOUR_TOKEN>

sudo localtonet --start-service --authtoken <YOUR_TOKEN>

The unit file is created at /etc/systemd/system/localtonet.service. Check status with systemctl status localtonet or view live logs with journalctl -u localtonet -f. Use --stop-service, --status-service, or --remove-service to manage it.

Documentation Linux Docs

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 VPN, switch to the VPN service:
```
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service
```
For upgrades, install the new package and run sudo systemctl restart localtonet. Your configuration is preserved.

If you use VPN, restart localtonet-vpn.service instead.
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 VPN, switch to the VPN service:
```
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service
```
For upgrades, install the new package and run sudo systemctl restart localtonet. Your configuration is preserved.

If you use VPN, restart localtonet-vpn.service instead.
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 VPN, switch to the VPN service:
```
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service
```
For upgrades, install the new package and run sudo systemctl restart localtonet. Your configuration is preserved.

If you use VPN, restart localtonet-vpn.service instead.
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 VPN, switch to the VPN service:
```
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service
```
For upgrades, install the new package and run sudo systemctl restart localtonet. Your configuration is preserved.

If you use VPN, restart localtonet-vpn.service instead.

Localtonet for OpenWrt

Experimental

Run Localtonet on your router with a package for your firmware and architecture.

Download

IPK for OpenWrt 24.10 · APK v3 for 25.12+ · x64 and ARM64

Check your router before installing. Match the package to your firmware architecture and check available storage and RAM. MIPS, MIPSEL and ARMv7 are not supported. These APK files are OpenWrt packages, not Android apps.

Install the package

Transfer the download to your router, then open a root SSH session in that directory. Verify the architecture before installing.

opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-x64.ipk
Add your AuthToken

Edit /etc/localtonet/auth-token as root. Replace DUMMY_AUTH_TOKEN with your token on a single line, then protect the file and verify the configuration.

chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
Enable automatic startup

Once the configuration check succeeds, enable the service and check its logs.

uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonet

To upgrade, install the new package and restart the service. Your configuration is preserved.

Documentation Package setup instructions

Packages are unsigned and experimental. Validate firmware compatibility, tunnels and VPN on your device. Never force a mismatched architecture.

Localtonet for NAS / Home Assistant

Setup templates

Connect your NAS or Home Assistant with ready-to-configure deployment templates.

Deployment templates ZIP · AMD64 / ARM64

Download

Synology Container Manager · QNAP Container Station · Home Assistant

Choose the setup for your device. Use Docker Compose on a Docker-capable NAS or Home Assistant Container / Core host. Home Assistant OS / Supervised uses the included local app template.

Extract the templates

Download and extract the ZIP, then open README.txt for the full setup instructions. The archive includes both NAS and Home Assistant templates.
Set up your device

NAS / Docker Compose

Copy nas/auth-token.example to nas/auth-token, enter your AuthToken and keep the file private. Check that the image tag in nas/compose.yaml is available in the registry.

Import the Compose file as a project in your container manager, or run this command from the nas directory:

docker compose up -d

Home Assistant OS / Supervised

Follow the local app installation steps in README.txt, then enter your AuthToken in the app configuration.

Documentation Full setup guide included in README.txt

These are setup templates, not SPK / QPKG installers or an official Home Assistant store listing. They use Linux host networking for LAN access and do not enable VPN privileges.

Localtonet for Docker

Run Localtonet in a container with the official Docker image.

Go to Docker Hub

Start Localtonet with Your Token:
This ensures you have the most up-to-date version of Localtonet

docker pull localtonet/localtonet

Start the container and pass your token.

docker run localtonet/localtonet --authtoken <YOUR_TOKEN>

This stores the token locally. Once authenticated, Localtonet is ready to use.

Documentation Docker Docs

Download Localtonet

Localtonet for Windows

Localtonet for macOS

Localtonet for Linux

Linux packages

Localtonet for OpenWrt

Install the package

Add your AuthToken

Enable automatic startup

Localtonet for NAS / Home Assistant

Extract the templates

Set up your device

NAS / Docker Compose

Home Assistant OS / Supervised

Localtonet for Android

Localtonet for Docker

Zero-install SSH