Back
Install Macula
Three ways onto the mesh, depending on what you're doing.
macula-cli
Test, monitor, and diagnose the Macula mesh from a terminal — the go-to tool for a human at a keyboard.
curl -fsSL https://raw.githubusercontent.com/macula-io/macula-cli/master/install.sh | bash
Linux / macOS / Windows
Go 1.27+ (source build alternative)
macula-mcp
A Model Context Protocol server that gives an AI agent harness — Claude Code, Cursor, Cline, Continue, or anything else that speaks MCP — direct access to the mesh.
npm install -g --allow-scripts=@macula-io/mcp @macula-io/mcp
.mcp.json
{
"mcpServers": {
"macula": { "command": "macula-mcp" }
}
}macula-station
Relay infrastructure — routes mesh traffic between peers. Run one if you're operating a relay, not for ordinary daily use.
docker pull ghcr.io/macula-io/macula-station:latest
A station needs a certificate derived from its own Ed25519
identity — the wrong kind boots fine and then silently fails
every connection. Read the Deployment Guide before running this
for real.
After Installation
Join a realm to start making mesh calls under an identity it recognizes.