Install the voidbox CLI

Each release ships voidbox together with a kernel and initramfs so you can run workloads out of the box.

Shell installer (Linux & macOS)

curl -fsSL https://raw.githubusercontent.com/the-void-ia/void-box/main/scripts/install.sh | sh

Installs to /usr/local/bin and /usr/local/lib/voidbox/. For a specific version: VERSION=v0.1.2 curl -fsSL ... | sh.

Homebrew (macOS)

brew tap the-void-ia/tap
brew install voidbox

Debian / Ubuntu

Download the .deb for your CPU (amd64 or arm64) from Releases. Example for v0.1.2 on amd64:

curl -fsSLO https://github.com/the-void-ia/void-box/releases/download/v0.1.2/voidbox_0.1.2_amd64.deb
sudo dpkg -i voidbox_0.1.2_amd64.deb

Fedora / RHEL

sudo rpm -i https://github.com/the-void-ia/void-box/releases/download/v0.1.2/voidbox-0.1.2-1.x86_64.rpm

Use the matching .rpm name from Releases for your version and architecture.

Cargo

If you use Rust already, you can also install via Cargo for the CLI only — pair it with kernel and initramfs from a release tarball or another install method above.

cargo install void-box

Next Steps

Getting Started	First run, environment variables, API keys
Running on Linux	KVM setup, guest images, and test workflows
Running on macOS	Apple Silicon setup with Virtualization.framework