Using the web UI

BarkVisor is a headless daemon that manages QEMU virtual machines and serves a web console. Install it on a Device (macOS, Linux) and open http://<device>:7777 in a browser — nothing to launch by hand; the daemon serves the UI itself. To hack on the UI or daemon, see Development.

Sign in with Sign in with passkey when the page is https (or localhost) on a hostname. Register more under Settings → Passkeys. A raw IP (127.0.0.1) hides the button — use localhost.

First run

Before sign-in, the setup wizard walks you through creating the Home:

• Set up this Device — add a passkey and pick the Library folder. This makes the machine the first Device of a new Home.
• Join an existing Home — paste or scan a pairing offer (barkvisor://pair/v1?…) issued by another Device in the Home.

Details live in First launch and Home and pairing.

Roles

• Admin — full access to every menu point described here.
• Inference — sees Ollama and lands there after sign-in. Everything else stays hidden.

Reading the shell

Around every page sit four shared pieces of chrome:

• Sidebar — the navigation listed below. On small screens it collapses behind a hamburger button.
• Device scope selector — at the top of the sidebar, “…scope” switches between All (the union of the Home) and one Device. List pages filter to that scope. Creating a VM keeps its own placement picker regardless.
• Ops ticker — the strip above the content shows live counts of running, failed, stopped, and unreachable Workloads/Devices, with a pulsing dot on problems and a Live marker on the right.
• Bottom of the sidebar — a Light/Dark mode toggle and Logout.

Every menu point

Menu	Page
Dashboard	Dashboard
Devices	Devices
Virtual Machines	Virtual Machines and Workload details
Ollama	Ollama
Images	Images
Disks	Disks
Networks	Networks
Logs	Logs
Settings	Settings — one page per tab

Related

• Quickstart — download an image, create your first VM
• Product terminology — Home, Device, Workload
• Troubleshooting