v0.2.0

What's changed

Commits since v0.1.0:

• feat(virtiofsd): checksum-verify source + build in a VM when no container runtime (#25) (79df060)
• docs(windows): record that WHPX cannot accelerate nested guests (#24) (65f23c9)
• feat(qmp): add vee qmp command with daemon-routed QMP client tooling (#23) (4622ae1)
• fix(windows): make WHPX guests boot (irqchip + docker SSH hostfwd) (#22) (2ef5dfc)
• fix(windows): tear down install scratch disk + anchor template disks under VM dir (#21) (9aaf62f)
• fix(windows): install Windows 11 24H2 end-to-end via writable scratch disk (#17) (#20) (56ba90e)
• fix(config): anchor relative config paths under ~/.vee (#19) (dc6f19c)
• ci: bump action-gh-release to v3.0.2 (61ac865)

Full changelog: v0.1.0...v0.2.0

---

Install

Download the asset for your platform, verify the checksum, and put vee on your PATH. vee drives QEMU, so install your host's QEMU packages too — see the Installation guide.

Linux

VEE_VERSION=v0.2.0
ASSET="vee-${VEE_VERSION}-linux-amd64"   # or linux-arm64
BASE="https://github.com/Benehiko/vee/releases/download/${VEE_VERSION}"

curl -LO "${BASE}/${ASSET}.tar.gz"
curl -LO "${BASE}/${ASSET}.tar.gz.sha256"
sha256sum -c "${ASSET}.tar.gz.sha256"          # must print: OK

tar xzf "${ASSET}.tar.gz"
install -Dm755 vee "$HOME/.vee/bin/vee"
export PATH="$HOME/.vee/bin:$PATH"             # add to ~/.bashrc

macOS (Apple Silicon)

VEE_VERSION=v0.2.0
ASSET="vee-${VEE_VERSION}-darwin-arm64"        # Intel: darwin-amd64
BASE="https://github.com/Benehiko/vee/releases/download/${VEE_VERSION}"

curl -LO "${BASE}/${ASSET}.tar.gz"
curl -LO "${BASE}/${ASSET}.tar.gz.sha256"
shasum -a 256 -c "${ASSET}.tar.gz.sha256"      # must print: OK

tar xzf "${ASSET}.tar.gz"
mkdir -p "$HOME/.vee/bin" && install -m755 vee "$HOME/.vee/bin/vee"
xattr -d com.apple.quarantine "$HOME/.vee/bin/vee" 2>/dev/null || true   # unsigned binary
export PATH="$HOME/.vee/bin:$PATH"             # add to ~/.zshrc

Windows (PowerShell)

$Version = "v0.2.0"; $Asset = "vee-$Version-windows-amd64"
$Base = "https://github.com/Benehiko/vee/releases/download/$Version"

Invoke-WebRequest "$Base/$Asset.tar.gz"        -OutFile "$Asset.tar.gz"
Invoke-WebRequest "$Base/$Asset.tar.gz.sha256" -OutFile "$Asset.tar.gz.sha256"

$expected = (Get-Content "$Asset.tar.gz.sha256").Split()[0].ToLower()
$actual   = (Get-FileHash "$Asset.tar.gz" -Algorithm SHA256).Hash.ToLower()
if ($expected -ne $actual) { throw "checksum mismatch" }

tar xzf "$Asset.tar.gz"
New-Item -ItemType Directory -Force "$HOME\.vee\bin" | Out-Null
Move-Item -Force vee.exe "$HOME\.vee\bin\vee.exe"

Verify the install: vee --help

Run as a daemon (Linux)

The daemon autostarts VMs on boot and stops them cleanly on host shutdown:

vee daemon install               # writes /etc/systemd/system/vee.service, enables + starts it
sudo systemctl restart vee       # after upgrading the vee binary in place
sudo systemctl status vee        # check it's running

After upgrading, restart the daemon so it runs the new binary. If the new binary lands at a different path, re-run vee daemon install.