KVM / Libvirt — Virtualization

If you like this project, consider supporting me on Buy Me a Coffee ☕️

KVM / Libvirt — Virtualization Cheatsheet

KVM (Kernel-based Virtual Machine) is a Linux kernel module that turns Linux into a Type-1 hypervisor. Libvirt provides the management layer (virsh, virt-manager, virt-install) on top of KVM/QEMU. This cheatsheet covers day-to-day operations, template creation, and production best practices.

Installation & Configuration

Install KVM Stack / Установка стека KVM

Debian / Ubuntu

sudo apt install -y qemu-kvm libvirt-daemon-system libvirt-clients virtinst bridge-utils virt-manager  # Install full stack / Установить полный стек
sudo apt install -y libguestfs-tools  # For virt-sysprep, virt-customize / Для работы с образами

RHEL / CentOS / AlmaLinux

sudo dnf install -y @virtualization  # Install virtualization group / Установить группу виртуализации
sudo dnf install -y libguestfs-tools virt-install  # Image tools / Инструменты для образов

Enable Libvirt Service / Включение сервиса Libvirt

sudo systemctl enable --now libvirtd  # Enable and start / Включить и запустить
sudo systemctl status libvirtd        # Check status / Проверить статус

Verify KVM Support / Проверка поддержки KVM

egrep -c '(vmx|svm)' /proc/cpuinfo   # Must return > 0 / Должно вернуть > 0
lsmod | grep kvm                       # Check loaded modules / Проверить загруженные модули
sudo virt-host-validate                # Full validation / Полная валидация

Sample Output:

QEMU: Checking for hardware virtualization     : PASS
QEMU: Checking if device /dev/kvm exists       : PASS
QEMU: Checking if device /dev/kvm is accessible: PASS

Add User to libvirt Group / Добавить пользователя в группу

sudo usermod -aG libvirt <USER>       # Add user to group / Добавить в группу
sudo usermod -aG kvm <USER>           # Add to kvm group / Добавить в группу kvm
newgrp libvirt                         # Apply without logout / Применить без перелогина

Configuration Paths / Пути конфигурации

• Libvirt config: /etc/libvirt/libvirtd.conf
• QEMU config: /etc/libvirt/qemu.conf
• VM definitions: /etc/libvirt/qemu/<VM_NAME>.xml
• Default storage pool: /var/lib/libvirt/images/
• Default network: /etc/libvirt/qemu/networks/default.xml

Default Ports / Порты по умолчанию

Log Locations / Расположение логов

• Libvirt daemon: /var/log/libvirt/libvirtd.log
• Per-VM QEMU logs: /var/log/libvirt/qemu/<VM_NAME>.log
• Journal: journalctl -u libvirtd

Logrotate Configuration / Конфигурация Logrotate

/etc/logrotate.d/libvirtd

/var/log/libvirt/libvirtd.log
/var/log/libvirt/qemu/*.log {
    weekly
    missingok
    rotate 12
    compress
    delaycompress
    notifempty
    postrotate
        systemctl reload libvirtd > /dev/null 2>&1 || true
    endscript
}

Core Management

Create VM with virt-install / Создать ВМ с virt-install

# Create VM from ISO / Создать ВМ из ISO
sudo virt-install \
  --name <VM_NAME> \
  --ram 2048 \
  --vcpus 2 \
  --disk path=/var/lib/libvirt/images/<VM_NAME>.qcow2,size=20,format=qcow2 \
  --os-variant ubuntu22.04 \
  --network bridge=br0 \
  --graphics vnc,listen=0.0.0.0 \
  --cdrom /var/lib/libvirt/images/<ISO_FILE> \
  --boot hd,cdrom

# Create VM from existing disk image / Создать ВМ из готового образа
sudo virt-install \
  --name <VM_NAME> \
  --ram 4096 \
  --vcpus 4 \
  --disk path=/var/lib/libvirt/images/<VM_NAME>.qcow2 \
  --os-variant centos-stream9 \
  --import \
  --network bridge=br0 \
  --graphics vnc

[!TIP] Use virt-install --os-variant list (or osinfo-query os) to list all supported OS variants. Choosing the correct variant optimizes virtio drivers and clock settings.

VM Lifecycle (virsh) / Жизненный цикл ВМ

virsh list --all                       # List all VMs / Список всех ВМ
virsh start <VM_NAME>                  # Start VM / Запустить ВМ
virsh shutdown <VM_NAME>               # Graceful shutdown / Мягкое выключение
virsh reboot <VM_NAME>                 # Reboot VM / Перезагрузить ВМ
virsh suspend <VM_NAME>                # Pause VM / Приостановить ВМ
virsh resume <VM_NAME>                 # Resume VM / Возобновить ВМ
virsh autostart <VM_NAME>              # Enable autostart / Включить автозапуск
virsh autostart --disable <VM_NAME>    # Disable autostart / Отключить автозапуск

[!CAUTION] virsh destroy forcefully kills the VM process (equivalent to pulling the power cord). Use only when virsh shutdown fails.

virsh destroy <VM_NAME>               # Force stop (DANGER) / Принудительное выключение

VM Information / Информация о ВМ

virsh dominfo <VM_NAME>                # Show VM details / Показать детали ВМ
virsh domblklist <VM_NAME>             # List block devices / Список дисков
virsh domiflist <VM_NAME>              # List network interfaces / Список сетевых интерфейсов
virsh vcpuinfo <VM_NAME>               # vCPU mapping / Маппинг vCPU
virsh dumpxml <VM_NAME>                # Full XML dump / Полный XML дамп

Delete VM / Удалить ВМ

virsh destroy <VM_NAME>                # Force stop first / Сначала выключить
virsh undefine <VM_NAME> --remove-all-storage  # Delete VM + disks / Удалить ВМ и диски
virsh undefine <VM_NAME> --nvram       # For UEFI VMs / Для UEFI ВМ

[!WARNING] --remove-all-storage permanently deletes all attached disk images. This is irreversible.

Console Access / Доступ к консоли

virsh console <VM_NAME>                # Serial console / Серийная консоль (Ctrl+] to exit)
virt-viewer <VM_NAME>                  # GUI console / Графическая консоль

Modify VM Resources / Изменить ресурсы ВМ

virsh setvcpus <VM_NAME> 4 --config    # Set vCPUs (next boot) / Установить vCPU
virsh setmaxmem <VM_NAME> 8G --config  # Set max RAM (next boot) / Установить макс. RAM
virsh setmem <VM_NAME> 4G --live       # Hot-change RAM / Изменить RAM на лету
virsh edit <VM_NAME>                   # Edit XML directly / Редактировать XML напрямую

Storage Management

Storage Pools / Пулы хранилища

virsh pool-list --all                  # List all pools / Список всех пулов
virsh pool-define-as <POOL> dir --target /var/lib/libvirt/images/  # Define pool / Определить пул
virsh pool-build <POOL>                # Build pool / Создать пул
virsh pool-start <POOL>                # Start pool / Запустить пул
virsh pool-autostart <POOL>            # Enable autostart / Автозапуск пула

Disk Image Operations / Операции с образами дисков

qemu-img create -f qcow2 <DISK>.qcow2 20G   # Create 20G disk / Создать диск 20G
qemu-img info <DISK>.qcow2                    # Show image info / Информация об образе
qemu-img resize <DISK>.qcow2 +10G             # Grow disk / Увеличить диск на 10G
qemu-img convert -f raw -O qcow2 <SRC>.raw <DST>.qcow2  # Convert format / Конвертировать формат

[!WARNING] Shrinking a qcow2 image is dangerous and can corrupt data. Always grow, never shrink without a full backup.

Attach/Detach Disks / Подключить/Отключить диски

virsh attach-disk <VM_NAME> /path/to/<DISK>.qcow2 vdb --subdriver qcow2 --persistent  # Attach disk / Подключить диск
virsh detach-disk <VM_NAME> vdb --persistent  # Detach disk / Отключить диск

Networking

Virtual Networks / Виртуальные сети

virsh net-list --all                   # List networks / Список сетей
virsh net-info default                 # Network details / Детали сети
virsh net-dhcp-leases default          # Active DHCP leases / Активные DHCP аренды
virsh net-start default                # Start network / Запустить сеть
virsh net-autostart default            # Enable autostart / Включить автозапуск

Bridge Networking / Мост (бриджевая сеть)

/etc/netplan/01-netcfg.yaml (Ubuntu/Netplan)

network:
  version: 2
  renderer: networkd
  ethernets:
    enp0s3:
      dhcp4: false
  bridges:
    br0:
      interfaces: [enp0s3]
      dhcp4: true

sudo netplan apply  # Apply bridge config / Применить конфигурацию моста

[!TIP] Bridge networking gives VMs direct access to the physical LAN, making them appear as separate hosts. NAT (default) is simpler but isolates VMs behind the host.

Template Creation

Creating VM templates allows rapid provisioning of identical, clean machines. The workflow involves preparing a base VM, cleaning it with virt-sysprep, and cloning it.

Production Runbook: Create a VM Template / Создание шаблона ВМ

1. Install base VM / Установить базовую ВМ

   sudo virt-install \
     --name template-ubuntu2204 \
     --ram 2048 --vcpus 2 \
     --disk path=/var/lib/libvirt/images/template-ubuntu2204.qcow2,size=20,format=qcow2 \
     --os-variant ubuntu22.04 \
     --cdrom /var/lib/libvirt/images/ubuntu-22.04-server.iso \
     --network bridge=br0 \
     --graphics vnc

2. Prepare the base VM (inside the guest) / Подготовить базовую ВМ (внутри гостя)

   sudo apt update && sudo apt upgrade -y     # Update packages / Обновить пакеты
   sudo apt install -y qemu-guest-agent cloud-init  # Install guest agent / Установить агент
   sudo apt clean                              # Clean APT cache / Очистить кэш
   sudo truncate -s 0 /etc/machine-id          # Reset machine ID / Сбросить machine-id
   sudo rm -f /etc/ssh/ssh_host_*              # Remove SSH host keys / Удалить ключи SSH
   sudo rm -rf /tmp/* /var/tmp/*               # Clean temp / Очистить временные файлы
   cat /dev/null > ~/.bash_history && history -c  # Clear history / Очистить историю
   sudo shutdown -h now                        # Shutdown / Выключить

3. Clean image with virt-sysprep / Очистить образ с virt-sysprep

   sudo virt-sysprep -d template-ubuntu2204 \
     --operations defaults,-lvm-uuids \
     --enable customize \
     --hostname template \
     --run-command 'dpkg-reconfigure -f noninteractive openssh-server'

[!IMPORTANT] virt-sysprep removes SSH keys, machine IDs, persistent network rules, and user data from the disk image, making it generic and ready for cloning.

4. Undefine VM but keep the disk / Убрать определение ВМ, сохранив диск

   virsh undefine template-ubuntu2204  # Undefine template VM / Удалить определение шаблона

5. Mark the template as read-only / Защитить шаблон от записи

   sudo chmod 444 /var/lib/libvirt/images/template-ubuntu2204.qcow2  # Read-only / Только чтение

Clone from Template / Клонирование из шаблона

Method 1: virt-clone (Full Copy / Полная копия)

sudo virt-clone \
  --original template-ubuntu2204 \
  --name <NEW_VM_NAME> \
  --file /var/lib/libvirt/images/<NEW_VM_NAME>.qcow2  # Full clone / Полная копия

Method 2: Linked Clone with Backing File (Fast / Быстрое связанное клонирование)

# Create linked clone (thin provisioning) / Создать связанный клон
sudo qemu-img create -f qcow2 \
  -b /var/lib/libvirt/images/template-ubuntu2204.qcow2 \
  -F qcow2 \
  /var/lib/libvirt/images/<NEW_VM_NAME>.qcow2

# Import the linked clone as a new VM / Импортировать связанный клон как новую ВМ
sudo virt-install \
  --name <NEW_VM_NAME> \
  --ram 2048 --vcpus 2 \
  --disk path=/var/lib/libvirt/images/<NEW_VM_NAME>.qcow2 \
  --os-variant ubuntu22.04 \
  --import \
  --network bridge=br0 \
  --graphics vnc

[!TIP] Linked clones use the template as a read-only backing file and only store the delta (differences). They are much faster to create and save disk space, but depend on the template image remaining intact.

Customize Clone with virt-customize / Кастомизация клона

sudo virt-customize -a /var/lib/libvirt/images/<NEW_VM_NAME>.qcow2 \
  --hostname <NEW_HOSTNAME> \
  --run-command 'dpkg-reconfigure -f noninteractive openssh-server' \
  --root-password password:<PASSWORD> \
  --timezone Europe/Berlin \
  --install nginx,htop

Clone Method Comparison / Сравнение методов клонирования

Snapshots & Backup

Snapshot Management / Управление снимками

virsh snapshot-create-as <VM_NAME> --name "<SNAP_NAME>" --description "Before upgrade"  # Create / Создать
virsh snapshot-list <VM_NAME>                     # List snapshots / Список снимков
virsh snapshot-revert <VM_NAME> --snapshotname "<SNAP_NAME>"  # Revert / Откатиться
virsh snapshot-delete <VM_NAME> --snapshotname "<SNAP_NAME>"  # Delete / Удалить

[!CAUTION] Reverting a snapshot discards all changes made after the snapshot was taken. This is irreversible.

Backup VM Disk / Бэкап диска ВМ

virsh shutdown <VM_NAME>               # Shutdown first / Сначала выключить
sudo cp /var/lib/libvirt/images/<VM_NAME>.qcow2 /backup/<VM_NAME>_$(date +%F).qcow2  # Copy disk / Скопировать диск
virsh dumpxml <VM_NAME> > /backup/<VM_NAME>.xml  # Backup XML config / Бэкап конфигурации

Restore VM from Backup / Восстановление ВМ из бэкапа

sudo cp /backup/<VM_NAME>.qcow2 /var/lib/libvirt/images/  # Restore disk / Восстановить диск
virsh define /backup/<VM_NAME>.xml     # Restore config / Восстановить конфигурацию
virsh start <VM_NAME>                  # Start VM / Запустить ВМ

Performance Tuning

CPU Pinning / Привязка CPU

/etc/libvirt/qemu/<VM_NAME>.xml

<vcpu placement='static'>4</vcpu>
<cputune>
  <vcpupin vcpu='0' cpuset='2'/>
  <vcpupin vcpu='1' cpuset='3'/>
  <vcpupin vcpu='2' cpuset='4'/>
  <vcpupin vcpu='3' cpuset='5'/>
</cputune>

Hugepages / Огромные страницы памяти

echo 1024 | sudo tee /proc/sys/vm/nr_hugepages  # Allocate 2MB hugepages / Выделить hugepages
grep HugePages /proc/meminfo                      # Verify / Проверить

/etc/libvirt/qemu/<VM_NAME>.xml

<memoryBacking>
  <hugepages/>
</memoryBacking>

VirtIO Drivers / Драйверы VirtIO

[!TIP] Always use virtio for disk and network devices. VirtIO is paravirtualized and significantly faster than emulated IDE/e1000 devices.

# Check current disk bus type / Проверить тип шины диска
virsh dumpxml <VM_NAME> | grep "target dev" | grep "bus"

Security

TLS for Remote Libvirt / TLS для удалённого доступа

/etc/libvirt/libvirtd.conf

listen_tls = 1
listen_tcp = 0
key_file = "/etc/pki/libvirt/private/serverkey.pem"
cert_file = "/etc/pki/libvirt/servercert.pem"
ca_file = "/etc/pki/CA/cacert.pem"

SELinux / sVirt Labels / Метки безопасности

sudo getenforce                        # Check SELinux status / Проверить статус SELinux
ls -lZ /var/lib/libvirt/images/        # Check sVirt labels / Проверить метки sVirt
sudo restorecon -Rv /var/lib/libvirt/images/  # Restore contexts / Восстановить контексты

Troubleshooting & Tools

Common Issues / Типичные проблемы

# VM won't start: permission denied on disk / ВМ не стартует: нет прав на диск
sudo chown qemu:qemu /var/lib/libvirt/images/<VM_NAME>.qcow2
sudo chmod 660 /var/lib/libvirt/images/<VM_NAME>.qcow2

# Check QEMU log for errors / Проверить лог QEMU
sudo cat /var/log/libvirt/qemu/<VM_NAME>.log | tail -50

# Network issues: restart libvirt network / Проблемы с сетью: перезапуск сети
virsh net-destroy default && virsh net-start default

Useful Diagnostic Commands / Полезные диагностические команды

virsh nodeinfo                         # Host hardware info / Информация о хосте
virsh capabilities                     # Hypervisor capabilities / Возможности гипервизора
virsh domstats <VM_NAME>               # VM resource stats / Статистика ресурсов ВМ
virt-top                               # Real-time VM monitor / Мониторинг ВМ в реальном времени

Comparison Tables

Virtualization Approach Comparison / Сравнение подходов виртуализации

Network Mode Comparison / Сравнение сетевых режимов