Install

Hiveloom is a single Rust binary. The fastest path is the release installer; building from source works too.

Recommended: one-line install

Linux (x86_64 or aarch64), macOS (Intel or Apple Silicon):


curl -fsSL https://bin.hiveloom.cloud/install.sh | bash

That installer:

Detects your OS and CPU architecture.
Downloads the matching hiveloom binary from https://bin.hiveloom.cloud/releases/latest/ into /usr/local/bin.
On Linux, also creates a hiveloom system user, prepares /var/lib/hiveloom, and writes /etc/systemd/system/hiveloom.service. It does not start the service.

Verify:


hiveloom --version

Install variants (pin a version, custom dir, no systemd, direct download)

Pin a specific version


curl -fsSL https://bin.hiveloom.cloud/install.sh | bash -s -- --version 0.2.0

Available versions are listed under https://bin.hiveloom.cloud/releases/. The latest alias always mirrors the most recent release.

Install somewhere other than `/usr/local/bin`


curl -fsSL https://bin.hiveloom.cloud/install.sh | bash -s -- --install-dir ~/.local/bin

Make sure the target directory is on your $PATH.

Skip the systemd service

For a user-level install (no service, no system user, no data dir):


curl -fsSL https://bin.hiveloom.cloud/install.sh | bash -s -- --no-service

Useful on macOS and on Linux developer laptops where you just want the CLI.

Direct binary download

If you don’t want to pipe to bash, pick the binary for your platform and install it yourself:


# Linux x86_64
curl -fsSL -o hiveloom https://bin.hiveloom.cloud/releases/latest/hiveloom-linux-x86_64
chmod +x hiveloom
sudo mv hiveloom /usr/local/bin/
 
# Linux aarch64
curl -fsSL -o hiveloom https://bin.hiveloom.cloud/releases/latest/hiveloom-linux-aarch64
 
# macOS Apple Silicon
curl -fsSL -o hiveloom https://bin.hiveloom.cloud/releases/latest/hiveloom-darwin-aarch64
 
# macOS Intel
curl -fsSL -o hiveloom https://bin.hiveloom.cloud/releases/latest/hiveloom-darwin-x86_64

SHA-256 checksums are published next to each binary as <name>.sha256.

Build from source


git clone https://github.com/FrancescoMrn/hiveloom-rust
cd hiveloom-rust
cargo build --release
./target/release/hiveloom --version

Requires a stable Rust toolchain (edition 2021).

Platform support matrix

Platform	One-line install
Linux x86_64	Yes (`linux-x86_64`)
Linux aarch64	Yes (`linux-aarch64`)
macOS aarch64 (Apple Silicon)	Yes (`darwin-aarch64`)
macOS x86_64 (Intel)	Yes (`darwin-x86_64`)
Windows	No — use WSL2

The guided journey assumes Linux (Ubuntu/Debian) as the VPS target. macOS is supported as a developer workstation; skip the deployment pages if you’re not running on Linux.

What you just installed

One binary with a lot of subcommands. Run hiveloom --help to see them. The most relevant for the next pages:

Command	What it does
`hiveloom serve`	Starts the HTTP service
`hiveloom agent`	Manages agents (create, list, show, delete)
`hiveloom credential`	Stores LLM provider API keys
`hiveloom chat`	Streams a conversation with an agent
`hiveloom tls render`	Prints a Caddyfile for a given hostname
`hiveloom mcp-identity`	Creates MCP client credentials

Full list at /cli.

Uninstall


# Stop and disable the service (Linux, if installed)
sudo systemctl stop hiveloom
sudo systemctl disable hiveloom
sudo rm /etc/systemd/system/hiveloom.service
 
# Remove the binary
sudo rm /usr/local/bin/hiveloom
 
# Remove the data directory (this deletes all tenants, agents, and credentials)
sudo rm -rf /var/lib/hiveloom
 
# Remove the service user
sudo userdel hiveloom

Go to Deploy on a VPS to make your instance reachable from the internet with Caddy, or to Cloudflare Tunnel for an outbound-only HTTPS path. If you just want a local playground, skip straight to Store an LLM credential.