// Getting Started

Downloads

Every Xerotier binary ships through GitHub Releases on Xerotier/binaries. The links on this page always resolve to the latest stable release: the xeroctl client, the XIM and XEM agents, and the desktop app, as direct downloads, Homebrew formulas, and Debian and RPM packages.

source: github.com/Xerotier/binaries
channel: releases/latest (stable)
platforms: macOS (Apple Silicon), Linux (x86_64)
license: MIT

What Ships

Static binaries are named <binary>-<OS>-<ARCH>, matching uname -s and uname -m on the target host, so a machine can always fetch its own build:

bash

                    curl -fLO "https://github.com/Xerotier/binaries/releases/latest/download/xeroctl-$(uname -s)-$(uname -m)"
                

Binary	What it is	macOS	Linux
`xeroctl`	Command-line client for the API and platform management	arm64	x86_64
`xerotier-xim-agent`	XIM inference agent	arm64	x86_64
`xerotier-xem-agent`	XEM execution agent	arm64	x86_64
`Xerotier-Desktop.dmg`	Desktop app: full client plus in-process XIM agent	arm64	-

macOS

Xerotier Desktop (DMG)

The notarized DMG is the recommended install on Apple Silicon (macOS 15+). Download Xerotier-Desktop.dmg -- the link always serves the newest build -- open it, and drag Xerotier.app into Applications. The app is a full client for the platform and runs the XIM agent in-process; see XIM on macOS.

Homebrew

bash

                    brew tap xerotier/tap
brew install xeroctl
brew install xerotier-xim-agent
brew install xerotier-xem-agent
brew install --cask xerotier-desktop
                

Homebrew resolves the zeromq and zstd libraries the agents link against; the cask installs the same notarized DMG. Formulas are pinned to the latest stable release in Xerotier/homebrew-tap.

Static binaries

bash

                    curl -fLO https://github.com/Xerotier/binaries/releases/latest/download/xeroctl-Darwin-arm64
chmod +x xeroctl-Darwin-arm64
sudo install xeroctl-Darwin-arm64 /usr/local/bin/xeroctl
                

The same pattern works for xerotier-xim-agent-Darwin-arm64 and xerotier-xem-agent-Darwin-arm64. Bare binaries load zeromq and zstd from Homebrew (brew install zeromq zstd).

Linux

Debian / Ubuntu (.deb)

Packages declare their library dependencies and install systemd units for the agents. Download from Xerotier/deb releases:

bash

                    sudo apt install -y ./xeroctl_*_amd64.deb
sudo apt install -y ./xerotier-xim-agent_*_amd64.deb ./xerotier-xem-agent_*_amd64.deb
                

RHEL / Rocky / Fedora (.rpm)

The agent packages depend on zeromq and libsodium, which ship in EPEL on RHEL and friends. Download from Xerotier/rpm releases:

bash

                    sudo dnf install -y epel-release
sudo dnf install -y ./xeroctl-*.x86_64.rpm
sudo dnf install -y ./xerotier-xim-agent-*.x86_64.rpm ./xerotier-xem-agent-*.x86_64.rpm
                

For both package families the agents install disabled: set the join key in /etc/xerotier/xim-agent.env or /etc/xerotier/xem-agent.env, then systemctl enable --now xerotier-xim-agent (or xerotier-xem-agent).

Static binaries

bash

                    curl -fLO https://github.com/Xerotier/binaries/releases/latest/download/xeroctl-Linux-x86_64
chmod +x xeroctl-Linux-x86_64
sudo install xeroctl-Linux-x86_64 /usr/local/bin/xeroctl
                

The same pattern works for xerotier-xim-agent-Linux-x86_64 and xerotier-xem-agent-Linux-x86_64. The binaries are statically linked against the Swift runtime; the agents additionally need libzmq, libsodium, and libzstd from your distribution.

Containers

Prefer containers for GPU inference hosts. Images and compose files live in Xerotier/container-agents and are documented on the XIM Deployment page.