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

mandaemonsReviewed March 6, 2026

virtqemud and virtproxyd roles

virtqemud manages QEMU/KVM guests. virtproxyd exists mostly so older clients and URI expectations still work even after the daemon split. virtqemud: where guest work happens Use virtqemud logs when a failure touches doma

virtqemudvirtproxydqemuproxy

virtqemud manages QEMU/KVM guests. virtproxyd exists mostly so older clients and URI expectations still work even after the daemon split.

virtqemud: where guest work happens

Use virtqemud logs when a failure touches domains, consoles, disks attached to a domain, CPU model negotiation, or migration handoff.

BASH
systemctl status virtqemud.service virtqemud.socket
journalctl -u virtqemud -n 200
virsh -c qemu:///system list --all

virtproxyd: when the proxy matters

virtproxyd is relevant when clients connect through compatibility sockets or remote transports that need an old public face but a new internal route.

Typical cases include:

  • Existing automation that still assumes libvirtd socket names.
  • Remote TLS/TCP entry points.
  • Mixed estates where some hosts are modular and others are not.

Common sockets to verify

BASH
ss -lx | grep -E "virtqemud|virtproxyd|libvirt"
systemctl list-sockets "virt*" "libvirtd*"

If the proxy socket is live but the driver daemon is not, clients may connect successfully and then fail during the real operation.

A good troubleshooting sequence

  1. Confirm the URI the client used.
  2. Check whether that URI lands on a proxy or directly on virtqemud.
  3. Read the matching systemd unit and journal.
  4. Only then inspect the domain XML or network/storage side effects.

Related

  • libvirtd overview and the compatibility daemon
  • Modular daemons context
  • Remote TLS, TCP, and auth basics

On this page

  • virtqemud: where guest work happens
  • virtproxyd: when the proxy matters
  • Common sockets to verify
  • A good troubleshooting sequence