Please note that you can only use your own domain with a Live server. Your Test server will use Divio's predefined URL.
Use a DNS provider
In order to use a custom domain with Divio, you will need to configure the DNS for your domain. We currently do not offer hosted DNS, so if your domain registrar does not offer DNS, you will need to use a third party service such as dnsimple.com.
Add a domain to your project
- In the Divio Control Panel, select your project.
- Select Domain Settings in the menu.
- Hit the Add domain button to add a custom domain.
- Enter the name of your domain and save your settings. You can use either a root domain (e.g. example.com) or a subdomain. (e.g. www.example.com or tutorial.example.com).
After you have added your domain, the Control Panel will display some suggested DNS configuration values and report whether it has been configured correctly.
After a check fails, the domain will be checked every 15 minutes until a correct set-up is detected. After a check finds it correct, checks will take place every 24 hours.
Adding a root domain
For a root domain (also known as a naked domain), they will include a suitable ALIAS configuration, and A records as an alternative.
We strongly recommend using ALIAS records over A records.
Adding a subdomain
For a subdomain, only CNAMEs will be listed.
You need an entry in the Divio Control Panel for each domain, including subdomains, at which you want your site to be available. An entry for
example.com will not automatically enable
If you want to serve your site at both
www.example.com you will need to add each to the Control Panel, and configure your DNS appropriately.
If you have multiple domains you will most likely want them to redirect to the primary domain. To set this, for each secondary domain in the control panel, select the Enable redirect option.
See also: our technical documentation for redirects on Divio Cloud.
Using the Control Panel's suggestions
Divio Cloud simply provides a suggestion of values to use. Even if you accept them, you will still need to enter them appropriately
Most DNS control panels will require you to enter the type of record, the name and the value into separate fields. Even in those that allow you to edit zone files, you will not be able simply to paste in the suggested values.
Your DNS provider will be able to give advice in how to implement these settings.
If you are using DNSimple, a DNSimple one-click service for Divio Cloud will help make this task quicker, easier and more reliable.
Using A records
Some DNS providers don't support ALIAS records.
In this case, for a root domain, use the IP addresses suggested by the Control Panel in an A record. As the Control Panel suggests, these addresses could change in the future. However, changes will be rare, and announced well in advance.
Multiple projects on a root domain
You can if you wish run multiple Divio Cloud projects that are associated with the same root domain. For example, you might have one project serving a site at
example.com, another at
intranet.example.com and another at
That's fine - all you need to do is ensure that each has the appropriate domain or subdomain set in the Control Panel.