17.2. remote-viewer

The remote-viewer is a simple remote desktop display client that supports SPICE and VNC. It shares most of the features and limitations with virt-viewer.

However, unlike virt-viewer, remote-viewer does not require libvirt to connect to the remote guest display. As such, remote-viewer can be used for example to connect to a virtual machine on a remote host that does not provide permissions to interact with libvirt or to use SSH connections.

To install the remote-viewer utility, run:

sudo yum install virt-viewer

# sudo yum install virt-viewer

The basic remote-viewer command-line syntax is as follows:

remote-viewer [OPTIONS] {guest-name|id|uuid}

# remote-viewer [OPTIONS] {guest-name|id|uuid}

To see the full list of options available for use with remote-viewer, use man remote-viewer.

If used without any options, remote-viewer lists guests that it can connect to on the default URI of the local system.

To connect to a specific guest using remote-viewer, use the VNC/SPICE URI. For information about obtaining the URI, see Section 14.5.19, “Displaying a URI for Connection to a Graphical Display”.

remote-viewer spice://testguest:5900

# remote-viewer spice://testguest:5900

remote-viewer vnc://testguest2:5900

# remote-viewer vnc://testguest2:5900

By default, the remote-viewer interface provides only the basic tools for interacting with the guest: