Skip to content

Virtualization Overview

gitsync edited this page Oct 4, 2026 · 2 revisions

ZNAS can run virtual machines and Linux containers next to your storage, managed entirely from the same portal. Virtualization is built on Incus (the LXD fork), with instance disks stored directly on your ZFS pools — so VMs get ZFS snapshots, replication, and compression for free.

VMs & Containers

What you get

Capability Details
Virtual machines Full KVM/QEMU VMs — Linux, Windows, BSD; UEFI or BIOS; PCI/GPU passthrough
Containers (LXC) Lightweight system containers sharing the host kernel
Docker Compose Deploy compose stacks onto instances straight from the portal, with auto-update schedules
ZFS-native storage Instance disks are ZFS datasets/ZVols in per-purpose datastores
Snapshots & backups Per-instance snapshots and schedules; full backups to local or remote datastores
Networking Managed bridges, VLANs, and a live topology map
Consoles Web terminal into containers/VMs, plus a graphical VGA console for VMs
Multi-server Manage several ZNAS hosts from one UI with InterLink

Enabling virtualization

Virtualization is optional and off by default. On the USB Appliance it is already installed and enabled.

  1. Go to Settings → Virtualization:

    Settings — Virtualization

  2. Enable the feature. The portal checks hardware requirements (CPU virtualization extensions, KVM availability, RAM) and tells you exactly what's missing if anything.

  3. Install the Incus packages when prompted (or from Requisites). The portal configures the daemon and creates the default ZFS datastore automatically.

Once enabled, Virtualization items appear in the sidebar and the sidebar mode selector (three small icons under the hostname) becomes available.

Sidebar modes

The sidebar has three modes, switched by the icons under the hostname selector:

Mode What the sidebar shows
Storage The classic NAS navigation (pools, datasets, shares…)
Compute The instance tree — every VM/container one click away, with per-instance pages
Networking Bridges and network objects

The instance list can be grouped by tags (right-click the Compute root) — tag instances (e.g. prod, lab) from their detail page.

Requirements

  • x86-64 CPU with VT-x/AMD-V (for VMs; containers work without)
  • KVM available (/dev/kvm) — the portal verifies this for you
  • Enough RAM for your instances on top of ZFS ARC
  • Debian 13+ / Ubuntu 26.04+ with the Incus packages (installed by the portal)

Where to go next

Clone this wiki locally