MacOS

Install Localtonet on macOS

Start with a simple token setup. When you’re ready, you can register and manage Localtonet as a background service (launchd). Homebrew and manual install options are provided.

1) Quick Install via Homebrew (Recommended)

Use our official tap to install Localtonet on macOS:

Homebrew tap & install
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.

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 your user and can be rotated or revoked any time from the dashboard.

3) Manual Install (Direct Downloads)

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

Apple Silicon (ARM64)

Download & install (ARM64)
curl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip
unzip localtonet-osx-arm64.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>

Intel (x64)

Download & install (x64)
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>
Use chmod 755 (not 777) and place the binary in a folder that’s on your PATH (for example /usr/local/bin), or call it by full path.

4) Service Mode (launchd)

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

5) Update & Uninstall (Homebrew)

Upgrade
brew upgrade localtonet
Uninstall
brew uninstall localtonet
brew untap localtonet/tap

Homebrew commands and tap usage are documented in your tap’s README.

Command Line Help

Help
localtonet --help

— Localtonet macOS Guide