Skip to content

Documentation v1.3.1

Start Localtonet on Boot

Install Localtonet as an operating system service so the client starts after reboot and continues running after logout.

Prerequisites

  • Localtonet is installed, and its executable is available at the installation path.
  • You have the device-specific Localtonet AuthToken.
  • You have Administrator privileges on Windows or sudo/root privileges on Linux and macOS.
  • Linux must use systemd. Termux is not supported.

Protect your AuthToken: Replace <YOUR_TOKEN> locally. Do not expose the resulting command in screenshots, repositories, support posts, documentation, or shared shell transcripts.

Install and start the service

  1. Windows: Open Command Prompt or PowerShell with Run as administrator, change to the directory containing Localtonet if necessary, and run:
    localtonet --install-service --authtoken <YOUR_TOKEN>
localtonet --start-service --authtoken <YOUR_TOKEN>
  2. Linux with systemd: Open a terminal and run:
    sudo localtonet --install-service --authtoken <YOUR_TOKEN>
sudo localtonet --start-service --authtoken <YOUR_TOKEN>
  3. macOS: Open Terminal and run:
    sudo localtonet --install-service --authtoken <YOUR_TOKEN>
sudo localtonet --start-service --authtoken <YOUR_TOKEN>

Service mode starts only the Localtonet client. Configure and start the required tunnel separately, with the correct device and relay option selected.

Verify automatic startup

  • Windows: Open services.msc or run localtonet --status-service --authtoken <YOUR_TOKEN> from an elevated shell.
  • Linux: Run systemctl status localtonet. For live journal output, run journalctl -u localtonet -f.
  • macOS: Run sudo localtonet --status-service --authtoken <YOUR_TOKEN> and confirm the launchd job exists under ~/Library/LaunchAgents/.
  • Reboot, wait for networking, and confirm in the Localtonet dashboard that the device reconnects and the required tunnel is running. Test the intended public endpoint.
support