> For the complete documentation index, see [llms.txt](https://docs.layeronecloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.layeronecloud.com/pve-microvm/webui.md).

# Web UI

Source project: `pve-microvm` (migrated from `docs/webui.md`). Run commands from the code checkout and directory specified below, not from this documentation repository.

## Create µVM button <a href="#create-vm-button" id="create-vm-button"></a>

The PVE header toolbar has a **Create µVM** button (⚡ bolt icon) next to Create VM and Create CT. It opens a dialog with:

* OCI image selector (12 Linux distros + specialist OS, freeform entry)
* Profile picker (minimal / standard / full)
* Storage picker (auto-filtered by node)
* VM ID (auto-populated from cluster)
* Memory, cores, disk size fields

The same option appears in the node right-click context menu.

## Microvm VM features <a href="#microvm-vm-features" id="microvm-vm-features"></a>

When a VM uses `machine: microvm`:

* **Resource tree**: ⚡ amber bolt icon (running/stopped/template states)
* **Console tab**: xterm.js serial terminal with bolt icon
* **Console button**: forces xterm.js (not noVNC)
* **Hardware view**: USB, PCI, BIOS, EFI, TPM, audio rows hidden
* **Add hardware menu**: unsupported devices disabled
* **Machine edit**: vIOMMU and version options hidden
* **Options panel**: unsupported options marked n/a
* **Context menu**: ⚡ Serial Console + ⚡ Clone microvm
* **Template right-click**: one-click clone

## Dark mode <a href="#dark-mode" id="dark-mode"></a>

All UI elements support PVE's dark theme automatically.

## Tags <a href="#tags" id="tags"></a>

Add `microvm` tag to any VM for the ⚡ icon:

```bash
qm set <vmid> --tags microvm
```

The template tool sets this automatically.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.layeronecloud.com/pve-microvm/webui.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.