v1

Getting Started /

Add and verify a domain

You can add your own domains and subdomains to Northflank to use with your deployed service's public ports.

Domains and subdomains are verified on your Northflank account, so once added you can reassign them to any public port for any deployment on your account.

If you use OVH, Cloudflare, NS1, or Namecheap, check our specific guides for these domain registrars.

Add a domain

You can add any domain (for example one.yourdomain.com) provided you have the ability to edit the DNS records.

  1. Open the domains page in your account settings.
  2. Click add domain, enter your domain name, and click add domain
  3. You will now see the information required to verify your domain, including the record name and record content. You will need to add this to your DNS records as a text (TXT) record.
Add a domain
  1. Open a new browser tab or window and navigate to your DNS provider
  2. Log in to your control panel and find the DNS settings for your domain
  3. Add a new text (TXT) record with the record name and record content specified in the entry you just generated for the domain on Northflank
  4. Return to the Northflank domains page and select verify on the entry for your domain
  5. Northflank will attempt to verify your domain - if not, check you have entered the record correctly and try again. If you need to, you can close the verification dialogue and come back to it later.
Verify a domain

Add a subdomain

You can add any subdomain provided you have the ability to edit the DNS records.

  1. Open the domains page in your account settings
  2. Click add subdomain and select the root domain name you want to create a subdomain for
  3. Enter the subdomain you want to use and click add subdomain
  4. You will now see the information required to verify your domain, including the record name and record content. You will need to add this to your DNS records as a CNAME, ALIAS, or APEX record (depending on host).
Add a subdomain
  1. Open a new browser tab or window and navigate to your DNS provider
  2. Log in to your control panel and find the DNS settings for your domain
  3. Add a new CNAME record with the record name and record content specified in the entry you just generated for the subdomain on Northflank
  4. Set the time to live (TTL) as recommended, or as low as you can to make your domain available as soon as possible
  5. Return to the Northflank domains page and select verify on the entry for your subdomain
  6. Northflank will attempt to verify your domain - if it doesn't verify, check you have entered the record correctly and try again. If you need to, you can close the verification dialogue and come back to it later.
  7. Once verified you can link the domain to port by selecting the desired service and port
Verify a subdomain

You can link a domain with a service's port from the domains page using the drop down menus next to the domain you want to link. Select the service and port you want to link and save changes. You can edit multiple subdomains at the same time.

Alternatively you can manage a service's linked domains from the ports & DNS page on the service itself:

  1. Open the ports & DNS page on the service that contains the port you want to link
  2. Make sure your port is using the HTTP protocol and is publicly exposed
  3. Open the custom domains & security rules options
  4. Select the subdomain to link to the port
  5. Click update

Northflank will automatically generate TLS certificates for your domain or subdomain and your domain should redirect to your specified port soon after saving.

Link a port to a subdomain

© 2022 Northflank Ltd. All rights reserved.