Linux

Install Localtonet on Linux

Start with a simple token setup. When ready, you can register Localtonet as a service. See Termux and VPN notes below.

1) Quick Install (Recommended)

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

Install script
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.

2) Basic Usage (No Service)

Authenticate this device using a token from Dashboard → My Tokens:

Authenticate
localtonet --authtoken <YOUR_TOKEN>

The token is stored locally for the current user and can be rotated or revoked anytime from the dashboard.

3) Manual Install (Direct Downloads)

Prefer a manual setup? Download the archive that matches your system, extract, and give execute permission.

glibc-based distros (Ubuntu, Debian, Fedora, RHEL, …)

musl-based distros (Alpine, some containers)

Example (x64, glibc):

Manual install (user-space)
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>

4) Service Mode (systemd)

To use your Localtonet app as a Service, check out the blog here.

5) Termux (Android) — Manual .deb Install

Termux is not systemd-based, so service commands are not supported. VPN is also not available in Termux.

  • Download the Termux package: localtonet-termux.zip
  • Extract it — you’ll get localtonet.deb.
  • Install the package with pkg, then run localtonet.
Termux install
wget https://localtonet.com/download/localtonet-termux.zip
unzip localtonet-termux.zip
pkg install ./localtonet.deb
localtonet --authtoken <YOUR_TOKEN>
  • No service mode on Termux: --install-service, --start-service, etc., are not supported.
  • VPN not available on Termux. To use Localtonet’s VPN on Android, install our official app from Google Play.

Command Line Help

Help
localtonet --help

— Localtonet Linux & Termux Guide