Download
Beta builds, always pointing at the latest published version. We detect the platform you're on and offer that one big; the others sit underneath so you can grab any of them for any machine. Linux ships in amd64 / arm64 / armv7 plus headless variants for boxes without a desktop — handy if you're setting up a server, a Pi, or anything without a browser.
Loading manifest…
Other platforms
Install
Each tarball/zip is self-contained. Extract, then run the bundled install script — it pulls in system dependencies on Linux and copies binaries plus a service into place on Windows.
Quick install (Linux, one line)
Detects your CPU architecture, fetches the matching tarball, verifies
sha256, and runs the bundled install script. Defaults to the
agent; pass --coord for a coordinator.
Picks the headless variant automatically on Pis or hosts with no
desktop session.
curl -fsSL https://mesh.mokatai.io/install.sh | sudo bash
Other variants:
sudo bash -s -- --coord (install a coordinator),
sudo bash -s -- --agent --headless (force headless on
a desktop box),
sudo bash -s -- --version v0.17.0 (pin a specific
version).
Which Linux variant?
- amd64 (full) — standard for desktops, laptops, and servers with a desktop session. Includes the native admin app (coord) / native peer app (agent) plus the daemon.
- amd64 (headless) — same daemon, but skips the
webkit2gtk dependency and native window app. Use on NUCs/servers with
no desktop. Manage from the embedded web UI or
mesh tuiover SSH. - arm64 — Raspberry Pi 4/5, Jetson, and other 64-bit ARM boards. Headless only (no cross-compiled webview yet).
- armv7 — Raspberry Pi 2/3, Zero 2 W, and other 32-bit ARM boards. Headless only.
If you grab the wrong architecture, install.sh refuses
with a clear error before touching anything — the script sniffs the
tarball's ELF header against uname -m.
Linux coordinator
# Replace amd64 with arm64, armv7, or amd64-headless as needed.
tar -xzf mokatai-mesh-vX.Y.Z-coord-linux-amd64.tar.gz
cd mokatai-mesh-coordinator-linux-amd64
sudo ./install.sh Linux agent
# Replace amd64 with arm64, armv7, or amd64-headless as needed.
tar -xzf mokatai-mesh-vX.Y.Z-agent-linux-amd64.tar.gz
cd mokatai-mesh-agent-linux-amd64
sudo ./install.sh Raspberry Pi (arm64 example)
tar -xzf mokatai-mesh-vX.Y.Z-agent-linux-arm64.tar.gz
cd mokatai-mesh-agent-linux-arm64
sudo ./install.sh
sudo mesh tui # interactive terminal UI to enroll the Pi into a mesh Windows agent
Run the …-setup.exe installer. The zip is the same build for airgapped or scripted installs — unzip and run install.bat from an Administrator PowerShell.
macOS agent (Apple Silicon)
Double-click the …-agent-darwin-arm64.pkg — it's Developer ID-signed and notarized, so it installs with no Gatekeeper warning. It sets up the agent as a launchd daemon plus the Mokatai Mesh app; open the app and paste your invite to join. Headless: sudo installer -pkg mokatai-mesh-vX.Y.Z-agent-darwin-arm64.pkg -target / then sudo mesh tui. Uninstall: sudo mokatai-mesh-uninstall.
Full walkthrough including coord setup, ACL rules, and peer enrollment lives in the quickstart.