Skip to content
libvirtd docs
Commands
LIBVIRT-MANUAL(7)49 indexed entries / 21 sections

From empty host to production control plane.

This manual explains what libvirt is, how its daemons and drivers cooperate, how to build with it, and how to recover it under pressure. Start with a path or enter by subsystem.

Open workbench Command index Rehearse a change

Guided routes

Choose an operating objective

PATH 01

Build the first host

Prepare KVM, install libvirt, validate acceleration, define a guest, and understand the control path.

host -> daemon -> domain
PATH 02

Operate the fleet

Use virsh safely, inspect state, automate definitions, observe drift, and establish daily checks.

inspect -> change -> verify
PATH 03

Design the data plane

Choose network modes, storage backends, bridges, pools, volumes, and guest device models.

uplink -> bridge -> guest
PATH 04

Harden and recover

Apply sVirt, SELinux, least privilege, backup boundaries, migration preflight, and incident order.

prevent -> detect -> restore

Subsystem index

Read the stack by layer

Layer 01

Foundations

Start with the host, control plane, domains, and declarative guest model.

6 sections / 13 entries

Overview

High-level orientation, daemon history, and where libvirt fits in the stack.

1

Installation

Packages, capabilities, host preparation, first validation, and a clean KVM baseline.

2

Platform

RHEL-family baselines, package discipline, systemd behavior, and host operating standards.

1

Concepts

Control-plane model, sockets, URIs, privilege boundaries, and mental models.

5

Domains

Guest lifecycle, persistent definitions, autostart, snapshots, consoles, and state transitions.

2

Domain XML

The declarative guest model: CPU, memory, disks, interfaces, devices, metadata, and safe edits.

2

Layer 02

Subsystems

Enter by daemon, command surface, network, storage, identity, or policy boundary.

9 sections / 24 entries

Identity

FreeIPA, SCIM, lifecycle authority, enrollment boundaries, and Linux access control.

1

Automation

Puppet, Foreman, Satellite, drift control, and repeatable control loops.

2

Daemons

Classic libvirtd and the modular daemon split such as virtqemud and virtproxyd.

3

virsh

Connection URIs, lifecycle operations, inspection commands, and daily workflows.

3

Networking

NAT, bridges, routed networks, isolated networks, and diagnostics.

5

Storage

Pools, volumes, backends, and the commands that attach storage to guests.

4

Security

SELinux, AppArmor, sVirt, and the policy knobs that commonly block guests.

3

Observability

Activity capture, telemetry surfaces, operator evidence, and system visibility.

2

Remote Access

SSH, TLS, TCP listeners, authentication, and proxying remote libvirt APIs.

1

Layer 03

Operations

Plan movement, protection, performance, recovery, and incident diagnosis.

6 sections / 12 entries

Migration

Preflight checks, live and offline moves, shared storage, transport, and rollback boundaries.

2

Backup

Quiescing, external snapshots, block jobs, restore testing, and recovery-point design.

2

Performance

CPU topology, NUMA, huge pages, I/O tuning, virtio, measurement, and contention control.

3

Recovery

Incident order, out-of-band access, storage recovery, and operator regain-of-control patterns.

1

Troubleshooting

Failure patterns, permissions, polkit, sockets, certificates, and recovery flow.

2

References

Service units, files, socket paths, and other operator lookup material.

2