Custom Domains
Manage custom domains for an install.
By default, each Nuon install will get configured with a <install-id>.nuon.run
root domain, which allows any component to
create or update DNS records.
While the nuon.run
domain works out of the box, it can be disabled or customized to support different types of
domains.
By default, both a public and private DNS zone are created.
Vendor Managed Domain
If you would like each of your installs to have a common root domain, such as installs.<your-domain>.com
, you can set
up a DNS zone and delegate each install’s nameservers.
First, configure your sandbox to use a custom root domain using:
Now, when an install is provisioned it will automatically create the DNS zone named install-id.your-domain.com
.
Next, the root domain must delegate to the install’s DNS zone.
This can be done by adding NS
records on the root domain.
First, find the nameservers for the public domain by inspecting the sandbox outputs:
Next, set up a DNS record on your root domain that delegates the install subdomain. This can be done via your provider’s console our if you are managing DNS using Terraform you can use a record similar to this:
Customer Managed Domain
You can allow a customer to bring their own domain by using an app input. Once the install is provisioned, the customer will be responsible for delegating the DNS subdomain. Please refer to the previous section for more details on how to delegate the domain.
To offer custom install domains, add the following to your config file:
Next, set the sandbox root domain to the input value:
Disabling DNS Zones
You can completely disable DNS in any sandbox by adding the following to your sandbox config: