Skip to main content

KVM / Libvirt Setup

The Hypervisor uses KVM and Libvirt for virtualization.

VM Management (Virsh)

virsh is the command-line interface for managing domains (VMs).

List VMs

sudo virsh list --all

Start a VM

sudo virsh start <vm_name>

Example: sudo virsh start dns-vm

Shutdown a VM

Graceful shutdown (requires guest agent).

sudo virsh shutdown <vm_name>

Force Stop (Destroy)

Immediate power off.

sudo virsh destroy <vm_name>

Console Access

Access the serial console of a VM.

sudo virsh console <vm_name>

Known VMs

  • dns-vm: DNS & VPN services.
  • cloud-storage-vm: Nextcloud server.
  • web-app-vm: Web server (Caddy, Forgejo, etc.).
  • game-server-vm: (Optional) Game servers like Minecraft.

Storage

VM images are typically stored in:

  • /mnt/storage/vm-images/
  • /var/lib/libvirt/images/