OVH Guides

Changing the hostname of a Public Cloud instance

Find out how to change the hostname of a Public Cloud instance

Last updated 18th September 2018


With the cloud-init module, you can configure your Public Cloud instance when you create it, and each time you reboot it. If you wish to reconfigure your hostname in order to fix an error creating your instance, or reconfigure your email server, you will need to disable the cloud-init module. This will configure the hostname so that it is not re-established.

This guide will show you how to reconfigure cloud-init so that you can modify your instance’s hostname.

OVH provides services which you are responsible for. In fact, as we not not have administrative access to these machines, we are not administrators and we cannot provide you with support. This means that it is up to you to manage the software and security daily.

We have provided you with this guide in order to help you with common tasks. However, we advise contacting a specialist provider if you experience any difficulties or doubts about administration, usage or server security. You can find more information in the "Go further" section in this guide.



Disable the cloud-init module.

To disable cloud-init, you will need to start by modifying the configuration file:

sudo vim /etc/cloud/cloud.cfg

Simply add the following two lines, or modify them if they already exist:

preserve_hostname: true
manage_etc_hosts: false

Modify the hostname.

The first step involves modifying the hostname:

sudo vim /etc/hostname

Next, you will need to modify the /etc/hosts file:

sudo vim /etc/hosts webserver.localdomain webserver localhost

You will then need to reboot the instance:

sudo reboot

After you reboot it, the hostname modifications will be properly applied:

sudo cat /etc/hosts webserver.localdomain webserver localhost

Go further

Join our community of users on

These guides might also interest you...