docs/doc/source/kube-virt/set-up-remote-management-of-vms-a082461d660e.rst

Set up remote management of VMs

Configure the kubectl, virtctl and virt-viewer clients on a remote workstation, in order to manage KubeVirt remotely. Note that the graphical console of a VM can only be accessed remotely from a workstation with X Windows (e.g. graphical ubuntu desktop), kubectl, virtctl and virt-viewer installed.

To configure kubectl and helm, you must have configured the oidc-auth-apps Identity Provider (dex) on the target environment to get Kubernetes authentication tokens. See Set up OIDC Auth Applications <configure-oidc-auth-applications> for more information.

Configure kubectl and helm

Configure virtctl

On the remote workstation, install virtctl client tool.

$ export VERSION=v0.53.1
$ wget https://github.com/kubevirt/kubevirt/releases/download/${VERSION}/virtctl-${VERSION}-linux-amd64
$ chmod a+x ./virtctl-${VERSION}-linux-amd64
$ sudo cp ./virtctl-${VERSION}-linux-amd64 /usr/bin/virtctl

Configure virt-viewer

On the remote workstation, install virt-viewer in order to enable use of graphical console.

$ sudo apt -y install virt-viewer