2026-02-18 06:55:01 -07:00
|
|
|
# virt-viewer
|
|
|
|
|
|
|
|
|
|
> Minimal graphical interface for a virtual machine (VM).
|
|
|
|
|
> Note: `domain` refers to the name, UUID, or ID for the existing VMs.
|
|
|
|
|
> See also: `virsh`.
|
|
|
|
|
> More information: <https://manned.org/virt-viewer>.
|
|
|
|
|
|
|
|
|
|
- Launch `virt-viewer` with a prompt to select running virtual machines:
|
|
|
|
|
|
|
|
|
|
`virt-viewer {{[-c|--connect]}} {{qemu:///system|qemu:///session|...}}`
|
|
|
|
|
|
|
|
|
|
- Launch `virt-viewer` for a specific virtual machine by ID, UUID, or name:
|
|
|
|
|
|
2026-07-08 16:22:34 -06:00
|
|
|
`virt-viewer {{[-c|--connect]}} {{uri}} {{domain}}`
|
2026-02-18 06:55:01 -07:00
|
|
|
|
|
|
|
|
- Wait for a virtual machine to start and automatically reconnect if it shuts down and restarts:
|
|
|
|
|
|
2026-07-08 16:22:34 -06:00
|
|
|
`virt-viewer {{[-c|--connect]}} {{uri}} {{[-r|--reconnect]}} {{[-w|--wait]}} {{domain}}`
|
2026-02-18 06:55:01 -07:00
|
|
|
|
|
|
|
|
- Connect to a specific remote virtual machine over TLS (requires pre-configured TLS certificates):
|
|
|
|
|
|
|
|
|
|
`virt-viewer {{[-c|--connect]}} {{qemu+tls://host/system}} {{domain}}`
|
|
|
|
|
|
|
|
|
|
- Connect to a specific remote virtual machine over SSH (requires SSH access to the host):
|
|
|
|
|
|
|
|
|
|
`virt-viewer {{[-c|--connect]}} {{xen+ssh://username@host/system}} {{domain}}`
|
