DNS and nameservers

How to set up external DNS services to work with Release

Select a domain to use with Release

Before you create a domain in Release, take a moment to decide whether you'll use an entire domain (in other words, all subdomains on a domain) for Release, or a single subdomain of your domain.

When to use an entire domain name

If you do not yet have a domain name, we recommend registering a new domain through your cloud provider.

Using a domain name dedicated to Release enables launching your live environments on Release and is recommended for applications that will use permanent environments, not only ephemeral environments.

For example, you could launch a permanent environment on www.example.com.

When to use a single subdomain

If you already use an external DNS server for your domain or your domain registrar does not support setting custom nameservers at domain-level (such as Cloudflare Registrar), we recommend using a subdomain for your Release applications.

This way, you can delegate DNS for the subdomain only to Release, while keeping full control over the rest of your domain with your current provider.

For example, if you choose to use release.example.com for your Release environments, you still have the option to use www.example.com and api.example.com for services outside Release.

Your Release environments will have domains that are one level down from your chosen subdomain, for instance, api-23r4wm-appname.release.example.com.

How to get nameservers from Release

When you create a domain in Release, we automatically create a DNS zone for your domain at your cloud provider. We use Route53 on AWS or Cloud DNS on GCP.

After creating the DNS zone, Release displays the nameservers your domain or subdomain should use.

How to configure your domain or subdomain to point to Release

Take note of the nameservers provided by Release, then follow one of the guides below to point your domain or subdomain to the Release nameservers:

Be prepared to wait for propagation

Domain changes sometimes take up to a day or two to propagate. This is due to how DNS resolvers cache records. To check the status of your domain's DNS propagation, use a tool such as DNS Propagation Checker or DNSMap.

Verify your domain in Release

Once the DNS change has propagated to most of the internet, you can verify your domain in Release and start using it for new environments.

Last updated