Skip to navigationSkip to content
libvirtd docs
InteractiveCommands

Manual nav

Search `/` · tty `~` · g top · G bottom

Portal

  • Manual index
  • Interactive lab
  • Command explorer
Foundations5 sections
  • libvirtd Overview1
  • Host & Installation2
  • Architecture & Concepts6
  • Domains2
  • Domain XML2
Subsystems6 sections
  • Daemons3
  • virsh3
  • Virtual Networking5
  • Virtual Storage4
  • Virtualization Security3
  • Remote libvirt1
Operations5 sections
  • Migration2
  • Snapshots & Backup2
  • Performance3
  • Troubleshooting2
  • Reference2
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

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

On this page

  • Inspect state
  • Controlled transitions
  • Persistence and autostart