Difference between revisions of "Node Provider Domain Name Guide"

From Internet Computer Wiki
Jump to: navigation, search
(Created page with "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 domai...")
 
m
Line 32: Line 32:
  
 
*Step 1: Create a free account with Cloudflare, click on “Add site” in the top bar of the dashboard.
 
*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 2: Enter your domain (e.g., <code>ic-domain.online</code>) and click “Add site”.
 
*Step 3: Choose the free plan and continue.
 
*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 4: Cloudflare will list two nameservers (e.g., <code>brianna.ns.cloudflare.com</code> and <code>kaiser.ns.cloudflare.com</code>) 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 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.  
 
*Step 6: Go back to the Cloudflare dashboard, click on Done, check nameservers.  

Revision as of 22:14, 5 February 2024

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.
    • PICTURE
  • Step 4: Repeat the same as above, but now select type “A” and use the IPv4 address
    • PICTURE
  • Finally, you should see the following two entries:
    • PICTURE

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>