Mastodon

Domain Name System (DNS)

Guides about the changes required to DNS needed for the deployment of an instance.

What is DNS?

One of the steps needed in order to set up one instance is for the subscriber to add a new DNS record to their domain.

What is DNS?

The Domain Name System (DNS) is the address book of the Internet. We access information online through domain names, like cloud68.co or mastodon.social. While web browsers interact through Internet Protocol (IP) addresses. DNS translates domain names to IP addresses, so browsers can load Internet resources.

Each device connected to the Internet has a unique IP address, which other machines use to find the device. DNS servers eliminate the need for humans to memorize IP addresses such as 192.168.1.1.

How does DNS work?

The process of DNS resolution involves converting a hostname (such as www.example.com) into a computer-friendly IP address (such as 192.168.1.1). An IP address is given to each device on the Internet, and that address is necessary to find the appropriate Internet device - like a street address is used to find a particular home. When a user wants to load a webpage, a translation must occur between what a user types into their web browser (example.com) and the machine-friendly address necessary to locate the example.com webpage.

What is a DNS record?

DNS records (aka zone files) are instructions that live in authoritative DNS servers and provide information about a domain including what IP address is associated with that domain and how to handle requests for that domain. These records consist of a series of text files written in what is known as DNS syntax. DNS syntax is just a string of characters used as commands that tell the DNS server what to do. All DNS records also have a ‘TTL’, which stands for time-to-live, and indicates how often a DNS server will refresh that record.

How can I add a new DNS record?

Different domain registrars provide different way for their clients to interact with the DNS services they provide. The best way to find the most relevant guide for your domain reseller is to search "the name of your domain reseller" add DNS record. 
We have a small list of major providers, from which you can follow the guides made by us.

How to add a new DNS record to your GoDaddy account

One of the steps needed in order to set up one instance is for you (our Subscriber) to add a new DNS record to their domain. You can learn more about DNS here.

To change the DNS on your GoDaddy account, please follow these steps:

  1. Log in to your Account. https://www.godaddy.com/.

  2. Navigate to Domains, select the domain that you wish to change the DNS settings on, and click Manage DNS.

  3. Under Records, your current DNS settings will be displayed.

  4. Click Add.

  5. Use the details that will/are provided on the email.

  6. Click save


Once these settings have been saved, you have successfully changed the DNS records for your domain. These changes may to 1 - 4 hours to propagate throughout the web.

You can use this website https://www.whatsmydns.net/ * to check the propagation of your newly added DNS record. Please be careful to select the appropriate record type.

* We are not affiliated with this site, feel free to use any other site.

How to add a new DNS record to your Namecheap account

One of the steps needed in order to set up one instance is for you (our Subscriber) to add a new DNS record to their domain. You can learn more about DNS here.

1. Login into the account where the domain was purchased.

2. Locate the domain which you wish to add the DNS record (you could have purchased multiple domains).

3. Click Manage.

4. Click Advanced DNS.

5. Scroll down if needed and click add new record.

6. Select the type of record (this info will be provided on the email, if you chose to use a subdomain the record type will be CNAME).

7. On the host field type the details send on the email ( in most cases will be a subdomain for example cloud.example.com, in this case you will need to input cloud on the host field).

8. on the value field input the info which is provided on the email (example of the value platform-subscriber.cloud68.systems.).

9. Click the “v” button to save your changes.


Once these settings have been saved, you have successfully changed the DNS records for your domain. These changes may take 1 - 4 hours to propagate throughout the web.

You can use this website https://www.whatsmydns.net/ * to check the propagation of your newly added DNS record. Please be careful to select the appropriate record type.

   * We are not affiliated with this site, feel free to use any other site.

How to add a new DNS record to your Hostinger account

One of the steps needed in order to set up one instance is for you (our Subscriber) to add a new DNS record to their domain. You can learn more about DNS here.

To change the DNS on your Hostiger account, please follow these steps:

  1. Log into your Hostinger account (if you are not logged in already).

  2. Click on domain and locate the domain you wish to add the new record (in case you have more than 1 domain).

  3. Click the arrow on the right of the domain.

  4. Right on top of DNS/Nameservers, you will see the domain nameservers, and below it, a section to choose between configuring DNS records, Child nameservers or DNSSEC. Click DNS records.

  5. Select the DNS record type, type into the Name field the information we have/will provide on the email. We refer to this as Host on our email. On the "Points to" field, paste the info provided on the email.

  6. Click Add record.

Once these settings have been saved, you have successfully changed the DNS records for your domain. These changes may take 1 - 4 hours to propagate throughout the web.

You can use this site, https://www.whatsmydns.net/ * to check the propagation of your newly added DNS record. Please be careful to select the appropriate record type.

* we are not affiliated with this site, feel free to use any other site. 

How to add a new DNS record to your Google Domains account

One of the steps needed in order to set up one instance is for you (our Subscriber) to add a new DNS record to their domain. You can learn more about DNS here.

To change the DNS on your Google Domain account, please follow these steps:

  1. Log into your Google Domains account (if you are not logged in already).

  2. Once you have logged in, you should see your domain name/s under the My Domains Section → click Manage.

  3. On the left-hand side, you should see the option to manage your DNS settings → Click on DNS in the left-hand menu.

  4. In the DNS section, scroll down to the Custom resource records section. Here, you can add and/or edit your DNS records.

  5. To add a new record, you will need to type in the fields the details that we will/have provided on the email. In most cases you will use a subdomain for your instance (e.x chat.example.com) for this case you will need to type chat on the first field, select CNAME from the record type, set a TTL of 1H and last field you will paste the details we have provided (e.x mattermost-c68.cloud68.systems.)

  6. Click save.


    Once these settings have been saved, you have successfully changed the DNS records for your domain. These changes may take 1 - 4 hours to propagate throughout the web.
    You can use this website https://www.whatsmydns.net/ * to check the propagation of your newly added DNS record. Please be careful to select the appropriate record type.

* we are not affiliated with this site, feel free to use any other site.

How to add a new DNS record to your DreamHost account

One of the steps needed in order to set up one instance is for you (our Subscriber) to add a new DNS record to their domain. You can learn more about DNS here.


1. Log in to your DreamHost Control Panel and click Manage Domains under Domains.

Screenshot 2023-01-17 at 15-31-46 Sign in · DreamHost.png

2. Click the DNS link for the domain you wish to use.

3. Navigate to the section Add a custom DNS record to your desired domain.

4. Enter the host provided on our email into the Name field.

5. Select the CNAME option from the Type drop-down menu.

6. Enter into the Value field the data we have provided on our email. (Please make sure you also include the dot at the end.)

7. Click on the Add Record Now! button.

Once these settings have been saved, you have successfully changed the DNS records for your domain. These changes may to 1 - 4 hours to propagate throughout the web.

You can use this website https://www.whatsmydns.net/ * to check the propagation of your newly added DNS record. Please be careful to select the appropriate record type.

* we are not affiliated with this site, feel free to use any other site.