Download TanMesh

Grab a pre-built binary or run from source. TanMesh is a single node binary that contains both the secure backend and the optional desktop GUI.

Linux (x86_64)

• Recommended for security-focused setups
• Works on Kali, Debian, Ubuntu, Arch & more

Download tanmesh-linux Install & verify

macOS

• Apple Silicon & Intel builds
• Works well with system Tor

Download tanmesh-macos Install & verify

Windows

• Self-contained binary
• Ideal for connecting to hardened Linux relays

Download tanmesh-windows Install & verify

Linux install

Install on Linux (Kali, Debian, Ubuntu…)

The Linux build is ideal for advanced users and security-focused workflows.

Ensure you have tor installed:
sudo apt install tor
Download the tanmesh-linux binary and make it executable:
chmod +x tanmesh-linux ./tanmesh-linux --name "Alice"
Wait for Tor to bootstrap; you’ll see your personal onion address printed in the banner.

# run in CLI mode
./tanmesh-linux --name "Alice" --cli

# force external Tor instead of embedded
TANMESH_TOR_SOCKS_HOST=127.0.0.1 \
TANMESH_TOR_SOCKS_PORT=9050 \
./tanmesh-linux --no-embedded-tor
            

On hardened systems, you can disable the embedded Tor instance and route TanMesh through your existing Tor configuration or a gateway box.

macOS install

Install on macOS

Install Tor (e.g. via Homebrew):
brew install tor
Download tanmesh-macos, move it into /Applications or any folder you like.
If macOS Gatekeeper blocks the app, allow it from System Settings → Privacy & Security.

# run with GUI (default)
./tanmesh-macos --name "Alice"

# force CLI mode inside a terminal
./tanmesh-macos --cli
            

Windows install

Install on Windows

Install Tor (system tor).
Download tanmesh-windows.
Double-click to launch the GUI, or run in cmd/PowerShell for CLI usage.

# in PowerShell, for CLI mode
.\tanmesh-windows --cli --name "Alice"
            

For best security, avoid running TanMesh on untrusted or corporate-managed Windows machines where you don’t control the OS.