Installation
boks runs on Linux, macOS, and Windows (via WSL2). You need a container runtime before installing boks.
Quick install
curl -fsSL https://boks.sh/install | shThis downloads the binary for your platform, verifies the SHA256 checksum, and installs it to ~/.local/bin/boks.
Then add ~/.local/bin to your PATH if it isn't already:
export PATH="$HOME/.local/bin:$PATH"
# Add to ~/.bashrc or ~/.zshrcWhat's in this section
- System Requirements — platforms and runtimes supported
- Container Runtime — install and configure Podman or Docker
- Installation Methods — installer script, manual install, build from source
- Post-Installation — verify the install, configure your shell
- Uninstallation — remove boks and its data
- Windows (WSL2) — running boks on Windows
Supported runtimes
| Runtime | Linux | macOS | Notes |
|---|---|---|---|
| Podman | yes | yes | Recommended — rootless, no daemon |
| Docker | yes | yes | Automatic fallback, or --runtime docker |
Podman is recommended because it runs rootless by default.