v1

To add a domain you will need to verify it by adding a DNS record on your DNS hosting service. Multiple accounts can add the same root domain but only one account will be able to link to the root domain.

Enter your root or apex domain name (e.g. yourdomain.com) to view the instructions to verify that you control that domain.

You will see the name and token to add your DNS records as a text (TXT) record, as well as the recommended time to live (TTL).

Log in to the control panel on your DNS provider and find the DNS settings for your domain. Add a new text record with the name and token specified in the entry you just generated for the domain on Northflank.

Verification

Return to your Northflank account's domains page and select verify on the entry for your domain. If it cannot be verified you may need to wait for the DNS to update, this will depend on the TTL set on the DNS host for the record. If it still fails to verify after the TTL has elapsed, check you have entered the record correctly and try again.

You can close the verification information to come back to it later, and view it again by clicking the verify button next to the entry.

You can now link your verified domain to a public port on a deployment.

You can add as many subdomains as you require for each domain but each subdomain on Northflank is unique; multiple accounts cannot add the same subdomain.

You can create as many levels of subdomains as required (for example one.yourdomain.com or three.two.one.yourdomain.com).

To add a subdomain, select the domain namespace to add it to (yourdomain.com) and enter the subdomain to add (one or three.two.one).

You will see the name and token to your DNS records as a CNAME (or ALIAS or APEX, depending on host) record, as well as the recommended time to live (TTL).

Log in to the control panel on your DNS provider, find the DNS settings for your domain, and add the record with the information specified on Northflank.

Verification

Return to your Northflank account's domains page and select verify on the entry for your domain. If it cannot be verified you may need to wait for the DNS to update, this will depend on the TTL set on the DNS host for the record. If it still fails to verify after the TTL has elapsed check you have entered the record correctly and try again.

You can close the verification information to come back to it later, and view it again by clicking the verify button next to the entry.

You can now link your verified subdomain to a public port on a deployment.

© 2021 Northflank Ltd. All rights reserved.