Manage domains

View domains

Navigate to the Account Settings page by clicking the Account Settings icon in the upper right corner of the window.

Settings button

Click Domains in the sidebar.

Domains page

Create a domain

Click the green Create New Domain button.

In the dialog, select the cloud integration the domain will be associated with and type in the domain name that will be used in clusters for your apps in Release.

New domain dialog

Click Create Domain. This will create a DNS record in the chosen cloud integration and return the name servers associated to it.

Domain details page

Now you can use the given name servers to add NS and CNAME records to your DNS manager for the top-level domain you have used. In this example, the top-level domain is example.org. You can add an NS record to point to the given name servers and a CNAME wildcard record that points to release.example.org. Read our External DNS guide for more information on setting up your external DNS.

Verify a domain

Once you have updated the DNS records in your host, return to the Domain Info page and click the green Verify button to compare the name servers on Release to those associated with the domain. In this example, Release will check to see which name servers are associated with release.example.org using DNS lookups. If the name servers match, the domain will show as verified on the Domain Info page. Verified domains can be used later to create a cluster.

Remove a domain

To remove a domain, go to the Domains page and click the domain to see the Domain Info page.

Domains page

Click the Delete button to show the delete confirmation dialog. The Delete button will be disabled if this domain is currently in use by any running clusters.

NOTE: You may only remove domains which are not in use with any active clusters. You can tell if any clusters are using a domain by navigating to the Domain Info page looking at the "In Use By" section.

Domain delete confirmation

Type in the domain and click the Delete button. This will remove the domain from Release and attempt to remove any DNS entries created for it.

NOTE: If the domain was part of an existing DNS entry created outside of Release, it will not be removed from the cloud provider. You may have to manually remove any entries which Release did not explicitly create in those situations.