Documentation
BarkVisor is a headless daemon plus Vue SPA for managing QEMU VMs through a web UI.
New here? Start with the shared Quickstart — download an image and create your first VM (same flow on macOS and Linux).
Get started
Section titled “Get started” Quickstart Create your first VM — works the same on macOS and Linux (arm64 / x86_64).
First launch Setup wizard and admin account — same flow on macOS and Linux.
Installation (macOS) System requirements, .pkg install, SSH install, data directory.
Linux Install checklist, packages, QEMU deps, systemd, first guest.
Development Build from source on macOS or Linux.
Troubleshooting Port conflicts, QEMU paths, SPA, bridge, and Linux-specific fixes.
Platforms
Section titled “Platforms”| Platform | Packaging | Acceleration | Bridged networking |
|---|---|---|---|
| macOS (Apple Silicon) | .pkg / standalone | HVF | socket_vmnet + privileged helper |
| Linux | .deb / .rpm / tarball | KVM (or TCG) | host bridge + qemu-bridge-helper |
Same product on both: daemon + SPA, NAT, bridge, USB, images, cloud-init, console/VNC. Host differences (accel, packaging) are by design.
Install on Linux — prebuilt packages and host checklist. Live flags: GET /api/system/capabilities.
Markdown source of truth: docs/ in the repo. This site is built from website/ (Astro + Starlight).