Please note that you can only use your own domain with a Live server. Your Test server will use Divio's predefined URL.

Note also that 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

  1. In the Divio Control Panel, select your project.
  2. Select Domain Settings in the menu.
  3. Hit the Add domain button to add a custom domain.
  4. 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). 

Configuring DNS

After you have added your domain, the Control Panel will display some suggested DNS configuration values.

Adding a root domain

For a root domain, they will include a suitable ALIAS configuration, and A records as an alternative.

Adding a subdomain

For a subdomain, only CNAMEs will be listed. 

Multiple domains

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 www.example.com.

If you want to serve your site at both example.com and www.example.com you will need to add each to the Control Panel, and configure your DNS appropriately.

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 trial.example.com.

That's fine - all you need to do is ensure that each as the appropriate domain or subdomain set in the Control Panel.

Did this answer your question?