Install the voidbox CLI

Each release ships voidbox together with a kernel and initramfs — the three files needed to run a workload.

Pick one:

• Any host, fastest path — the shell installer.
• Homebrew on macOS, or .deb / .rpm on Linux — platform packages below.
• Rust workflow — cargo install. Read the caveat: the CLI alone cannot run workloads.

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/. On macOS it also codesigns the binary with the com.apple.security.virtualization entitlement required by Virtualization.framework — so the installed binary boots guests without further setup. 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 — RPM names ARM as aarch64, not arm64.

Cargo

cargo install void-box

This installs the voidbox CLI only — no kernel, no initramfs. Running a workload fails until both are on disk. Extract them from a release tarball into /usr/local/lib/voidbox/, or run any of the methods above first.

Verify

voidbox version

Prints the installed version. If voidbox isn’t found, add the install prefix to your PATH — /usr/local/bin for the shell installer and Homebrew, /usr/bin for .deb / .rpm.

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