Node Provider Domain Name Guide

From Internet Computer Wiki
Jump to: navigation, search

For each IPv4-enabled node, you will need a hostname. This doesn’t have to be its own domain name, but can be a subdomain. For example, Gen1 node providers may use the domain obtained as part of the “New RMU Build – Gen 1.5”:

In these instructions, we refer to your domain as <domain>. You are completely free in choosing the domain and subdomain names. Following the convention from the “New RMU Build – Gen 1.5”, we recommend using nodeX.<dc>.<domain> (e.g., node1.aa3.nodeprovider.com).

Once you have decided on the name (e.g., nodeX.<dc>.<domain>). Then, you need to configure both an A and AAAA record that point to the IPv4- and IPv6-address of your node. The DNS records of your domain name can be configured after deploying the node. Look at the terminal of the deployed node and take note of the IP addresses reported: <ipv4> and <ipv6>.

Then, you need to create the following DNS records:

Name                   Type      Address
---------------------------------------------------------------
nodeX.<dc>.<domain>    A         <ipv4>
nodeX.<dc>.<domain>    AAAA      <ipv6>


Configuration Example

In the following, we explain how to configure the DNS records on the example of Cloudflare using the following fictitious values:

  • domain name: node-x.ic-domain.online
  • IPv4 address: 185.154.214.129
  • IPv6 address: 9f8d:7a2c:440b:cc98:13e1:3002:fb9a:7a18

Configuring Cloudflare as your DNS provider

Note: If you are already using Cloudflare to manage your DNS records of your domain, you can skip ahead to “Configuring your DNS Records”.

In order to use Cloudflare, you need to change the nameservers of your domain with your initial DNS provider:

  • Step 1: Create a free account with Cloudflare, click on “Add site” in the top bar of the dashboard.
  • Step 2: Enter your domain (e.g., ic-domain.online) and click “Add site”.
  • Step 3: Choose the free plan and continue.
  • Step 4: Cloudflare will list two nameservers (e.g., brianna.ns.cloudflare.com and kaiser.ns.cloudflare.com) that you should take a note of.
  • Step 5: Go to the management pane of your initial DNS provider and change the nameservers to the ones provided by Cloudflare.
  • Step 6: Go back to the Cloudflare dashboard, click on Done, check nameservers.
    • Note: This step can take several hours and you will be notified by email once it succeeded.

Configuring your DNS records

  • Step 1: Log in to your Cloudflare account and select your domain on the dashboard.
  • Step 2: Select “DNS” in the menu on the left.
  • Step 3: Click on “Add record”, select type “AAAA” and fill in the fields with the subdomain and the IPv6 address.
    • Configuring your DNS records 1.png
  • Step 4: Repeat the same as above, but now select type “A” and use the IPv4 address
    • Configuring your DNS records 2.jpg
  • Finally, you should see the following two entries:
    • Configuring your DNS records 3.jpg

Confirming your configuration

DNS Records

You can check your DNS records by running the following commands for IPv4 and IPv6, respectively:

$ dig A nodeX.<dc>.<domain> +short

$ dig AAAA nodeX.<dc>.<domain> +short

Make sure that the output of the two commands are the IP addresses that you intended to configure.

Ping

Run the following two commands in your terminal to ensure that your nodes can be reached through the configured domain name:

$ ping nodeX.<dc>.<domain>

$ ping6 nodeX.<dc>.<domain>