Using the KVM for a VPS

Find out how to access your VPS using the KVM functionality

Last updated 30th August 2022

Objective

The KVM console allows you to connect directly to your VPS without the need to use external software such as Terminal or PuTTY. This console is accessible via your OVHcloud Control Panel or the OVHcloud API.

This guide explains both of the KVM access methods.

Requirements

Instructions

Connecting to the KVM via the OVHcloud Control Panel

With a current VPS range

Log in to the OVHcloud Control Panel, go to the Bare Metal Cloud section and select your server under Virtual Private Servers. In this section, click on ... next to the name of your VPS in the "Your VPS" box.

Open KVM

With older VPS ranges

Log in to the OVHcloud Control Panel, go to the Bare Metal Cloud section and select your server under Virtual Private Servers. In this section, click on the shortcut link labelled KVM.

Click on the KVM button

Using the KVM console

The KVM screen will open, which is a small window showing a connection to your server. Since the window is rather small it will be quite difficult to navigate around your server's interface using the scrollbars. Therefore we recommend that you open the KVM in a new, full-screen window using the "Open in a new window" button in the bottom right corner of the popup.

You might experience double typing issues; this is caused by auto screen adjustment. We recommend opening the KVM in a new window using the "Open in a new window" button.

Should you still have issues with the screen, we recommend removing the "auto" part from the URL. If the URL is https://compute.sbg1.cloud.ovh.net:6080/vnc_auto.html?token=xxxxxxxxxxxx then it should become https://compute.sbg1.cloud.ovh.net:6080/vnc.html?token=xxxxxxxxxxxx (the link for you may be different, this is only illustrating which part of the URL needs to be removed).

Connecting to the KVM

The keyboard may have a different layout from your own. Be sure to check it, since the keyboard could be AZERTY instead of QWERTY, for example.

Changing the keyboard layout

You can enable your preferred keyboard configuration to make using the console more convenient. Enter the following command:

sudo dpkg-reconfigure keyboard-configuration

A graphical menu will open in which you can select a keyboard model.

KVM

Use the arrow keys to navigate to the option that comes closest to your hardware, then press "Enter".

In the next menu, choose your country.

KVM

In the third menu, you can specify your actual keyboard layout.

KVM

Depending on your selections, there may be further options showing up after the third menu.

Back at the command line, enter the following command to apply the changes.

sudo systemctl restart keyboard-setup

These steps need to be repeated after a server reboot.

Connecting to the KVM via the API

You may sometimes experience issues connecting to the KVM via your OVHcloud Control Panel, especially with older versions. In this case, you can use the API solution via the OVHcloud API.

For a 2014 VPS

If you have a 2014 VPS, you may encounter error 1006. Going through the API using the call below could resolve this.

API:
API call parameters:

serviceName

ID of your VPS in the format vpsxxxxx.ovh.net

protocol

VNC

Despite the command going through on the API, the connection might take a few minutes – the time it takes for the port to be successfully opened.

We recommend using either of the following clients:

Use the details provided by the API call to connect to the VPS remotely using either of the above-mentioned software clients.

For a 2016 VPS

If problems arise with the KVM, here is the recommended API for accessing the KVM:

API:
API call parameters:

serviceName

ID of your VPS in the format vpsxxxxx.ovh.net

Should you still have issues with the screen, we recommend removing from the URL the "auto" part. If the URL is https://compute.sbg1.cloud.ovh.net:6080/vnc_auto.html?token=xxxxxxxxxxxx then it should become https://compute.sbg1.cloud.ovh.net:6080/vnc.html?token=xxxxxxxxxxxx (the link for you may be different, this is only illustrating which part of the URL needs to be removed).

Go further

Join our community of users on https://community.ovh.com/en/.


Did you find this guide useful?

Please feel free to give any suggestions in order to improve this documentation.

Whether your feedback is about images, content, or structure, please share it, so that we can improve it together.

Your support requests will not be processed via this form. To do this, please use the "Create a ticket" form.

Thank you. Your feedback has been received.


These guides might also interest you...

OVHcloud Community

Access your community space. Ask questions, search for information, post content, and interact with other OVHcloud Community members.

Discuss with the OVHcloud community

In accordance with the 2006/112/CE Directive, modified on 01/01/2015, prices incl. VAT may vary according to the customer's country of residence
(by default, the prices displayed are inclusive of the UK VAT in force).