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.

OVHcloud provides services which you are responsible for. In fact, as we do 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

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