Install Mach5 One

Mach5 One is distributed as a versioned binary release.

Latest release:

https://github.com/mach5-io/mach5-one/releases/latest

Download

Choose the asset for your operating system and architecture:

Download checksums.txt from the same release.

Verify checksum

Linux:

sha256sum mach5-one-linux-amd64.tar.gz
cat checksums.txt

macOS:

shasum -a 256 mach5-one-darwin-arm64.tar.gz
cat checksums.txt

The computed checksum must match the corresponding line in checksums.txt.

Install on macOS or Linux

tar -xzf mach5-one-linux-amd64.tar.gz
chmod +x mach5-one
sudo mv mach5-one /usr/local/bin/mach5-one
mach5-one version

Use the archive name that matches your platform.

Install on Windows

PowerShell:

Expand-Archive .\mach5-one-windows-amd64.zip .\mach5-one
.\mach5-one\mach5-one.exe version

Initialize local config

mach5-one init

This creates:

~/.mach5-one/mach5-one.toml
~/.mach5-one/data/

Start Mach5 One

mach5-one start

The server prints its active endpoints on startup.

Default endpoints:

Web UI and HTTP API: http://localhost:8080
MCP:                 http://localhost:8080/mcp
PostgreSQL wire:     localhost:5432

Stop Mach5 One with Ctrl-C or by sending SIGTERM to the process.

Custom config path

mach5-one --config ./mach5-one.toml start

or:

export MACH5_ONE_CONFIG=./mach5-one.toml
mach5-one start

Troubleshooting

See troubleshooting.md.