Install
Install Blackhole
in 30 Seconds
One command. No configuration required. Joins the mesh automatically.
Terminal
$
curl (recommended)
blackhole assisted-install
apt (Debian/Ubuntu)
blackhole assisted-apt-setup sudo apt update && sudo apt install blackhole
yum (RHEL/CentOS)
sudo yum-config-manager --add-repo https://pkg.blackholemesh.dev/rpm/blackhole.repo sudo yum install blackhole
systemd unit
[Unit] Description=Blackhole Mesh Daemon After=network.target [Service] ExecStart=/usr/local/bin/blackhole agent Restart=always RestartSec=5 [Install] WantedBy=multi-user.target
Docker
docker run
docker run -d --name blackhole --network host --cap-add NET_ADMIN blackhole/agent:latest
Direct Binary Downloads
| Platform | File | Size | Download |
|---|---|---|---|
| linux/amd64 | blackhole-linux-amd64 | 18 MB | Download |
| linux/arm64 | blackhole-linux-arm64-nanoclaw | 17 MB | Download |
| linux/armv7 | blackhole-linux-armv7-nanoclaw | 15 MB | Download |
| linux/mips | blackhole-linux-mips-picoclaw | 14 MB | Download |
| darwin/arm64 | blackhole-darwin-arm64 | 16 MB | Download |
| darwin/amd64 | blackhole-darwin-amd64 | 16 MB | Download |
What happens during install
1
Download binary
Fetches the correct binary for your OS and architecture from the CDN.
2
Verify signature
Checks Ed25519 signature against the public key at blackholemesh.dev/keys.
3
Create config
Generates /etc/blackhole/config.yaml with your node identity and mesh settings.
4
Register identity
Creates an Ed25519 keypair. Public key is submitted to your control plane.
5
Start mesh daemon
Installs and starts the systemd/launchd service. Node joins the mesh.
Signature verification: All binaries are signed with Ed25519. Verify manually:
blackhole verify --key https://blackholemesh.dev/keys/pub.pem ./binary