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
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 modern daemon model
  • 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