Installing IncusOS

IncusOS is designed to run on modern physical hardware as that’s the optimal environment to run an Incus server.

But we also support having it run inside of a virtual machine, making it easier to evaluate or debug. In general, any physical or virtual environment which matches our hardware requirements should do fine. That said we recommend using generic storage and network adapters whenever possible, with NVMe, VirtIO or Intel virtual devices usually being preferred.

Note

For virtual machines, storage drives should be configured to use the VirtIO-scsi driver. Using VirtIO-blk does not work as the resulting drives will not appear to IncusOS in the same way as physical drives do.

Supported platforms

• Installing on hardware
• Installing on Incus
• Installing on libvirt
• Installing on Proxmox
• Installing on VirtualBox
• Installing on VMware

Unsupported platforms

So far we’re aware that IncusOS cannot be installed on top of Microsoft Hyper-V due to that virtualization platform not supporting custom Secure Boot keys.