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

mandomainsReviewed July 15, 2026

Domain lifecycle and state transitions

A libvirt domain is a guest definition plus its runtime state. Persistent definitions survive host reboots; transient domains disappear when stopped. Inspect state Controlled transitions shutdown requests an orderly gues

domainlifecyclestateautostart

A libvirt domain is a guest definition plus its runtime state. Persistent definitions survive host reboots; transient domains disappear when stopped.

Inspect state

BASH
virsh list --all
virsh domstate guest01 --reason
virsh dominfo guest01
virsh domid guest01

Controlled transitions

BASH
virsh start guest01
virsh shutdown guest01
virsh reboot guest01
virsh suspend guest01
virsh resume guest01

shutdown requests an orderly guest shutdown and requires a responsive guest. destroy is equivalent to removing power; reserve it for a documented recovery decision.

Persistence and autostart

BASH
virsh dominfo guest01 | grep Persistent
virsh autostart guest01
virsh autostart --disable guest01

Autostart is host policy, not high availability. It does not coordinate dependencies, fencing, storage ownership, or split-brain prevention.

Related

  • Safe domain XML editing
  • Daily domain operations with virsh
  • External snapshots and block jobs

On this page

  • Inspect state
  • Controlled transitions
  • Persistence and autostart