Skip to navigationSkip to content
libvirtd docs
Commands

Manual nav

Search `/` or jump with `g` / `G`.

Portal

  • Home manual
  • Command explorer
Foundations6 sections
  • Overview1
  • Installation2
  • Platform1
  • Concepts5
  • Domains2
  • Domain XML2
Subsystems9 sections
  • Identity1
  • Automation2
  • Daemons3
  • virsh3
  • Networking5
  • Storage4
  • Security3
  • Observability2
  • Remote Access1
Operations6 sections
  • Migration2
  • Backup2
  • Performance3
  • Recovery1
  • Troubleshooting2
  • References2

/ search · g top · G quickstart

manmigrationReviewed July 15, 2026

Migration preflight and compatibility contract

Migration is a compatibility contract between source, destination, storage, network, firmware, CPU model, and libvirt/QEMU versions. Prove each boundary before moving memory. Host checks Required decisions Is storage sha

migrationpreflightcpustorage

Migration is a compatibility contract between source, destination, storage, network, firmware, CPU model, and libvirt/QEMU versions. Prove each boundary before moving memory.

Host checks

BASH
virsh -c qemu+ssh://target/system version
virsh -c qemu+ssh://target/system domcapabilities
virsh dumpxml guest01 --migratable > /root/guest01.migratable.xml
virsh domblklist guest01 --details
virsh domiflist guest01

Required decisions

  • Is storage shared, copied, or replicated separately?
  • Does the destination expose compatible CPU features and machine types?
  • Are every network, secret, firmware, TPM, and host device dependency available?
  • What is the abort threshold for downtime, dirty rate, and remaining data?
  • Which host owns the guest if the management session fails?

Dry-run mindset

There is no substitute for testing the exact path with a representative workload. A successful empty-guest migration does not prove a write-heavy production guest will converge.

Related

  • CPU, memory, and device model
  • qcow2, raw, and allocation behavior
  • Live migration operator runbook

On this page

  • Host checks
  • Required decisions
  • Dry-run mindset