Updated by Linode Written by Linode
The Domains section of the Linode Manager is a comprehensive DNS management interface that allows you to add DNS records for all of your domain names. This guide covers the use of the Domains section and basic domain zone setup. For an introduction to DNS in general, see our Introduction to DNS Records guide.
The Domain Name System (DNS) attaches human-readable domain names to machine-usable IP addresses. In many ways, it is the phone book of the Internet. Just like a phone book can help you find the phone number of a business, DNS can take a domain name like
google.com and translate it into an IP address like
184.108.40.206. This global system allows users to remember the names of websites instead of their numeric IP addresses.
NoteAll steps within this guide are completed within the Domains page of your Linode Manager.
DNS Set-Up Checklist
DNS records are only actively hosted on accounts with at least one Linode. When setting up a domain name on your Linode, make sure you perform the following steps:
- Register (purchase) a domain name if you haven’t already.
- Set your domain name to use Linode’s name servers. You’ll need to do this on your domain registrar’s website and then wait up to 24 hours for the change to take effect.
- Use the DNS Manager to add a domain zone, and then start adding some basic DNS records.
- Set reverse DNS.
- If you have any special DNS needs, such as using a third-party email server, add additional DNS records to create a custom configuration.
Use Linode’s Name Servers with Your Domain
After you purchase a domain, log in to your domain registrar’s control panel and set the name servers for your domain name to the entries below. See the instructions on your domain name registrar’s website for more information.
NoteDNS changes can take up to 24 hours to propagate throughout the internet, although the changes are usually visible within several hours.
The DNS Manager
Log in to the Linode Manager and select the Domains link. It should resemble this:
- All of your domain zones are listed here. A domain zone, synonymous with the term “domain”, is a collection of DNS records for a single domain name. Click the name of a domain zone to add or edit DNS records within that zone.
- If you have a zone that can be exported from a server or another hosting provider, click Import a Zone to import it.
- Click Add a Domain to create a new domain zone.
- Use the links in the menu to the right of the domain zone link to edit DNS records within a zone, to check or delete a zone, to view a zone’s file, or select Clone to duplicate an existing zone.
Before you can add any DNS records, you must create a domain zone. Think of a domain zone as a container for DNS records associated with a single domain name.
Add a Domain Zone
If you’re new to Linode, or if you’ve just purchased a new domain name, the first step is to add a new domain zone in the DNS Manager.
From the DNS Manager tab, select Add a Domain:
If you want to add a slave zone instead of a master zone, click the Slave radio button.
In order for Linode’s DNS servers to function as slaves, your DNS master server must notify and allow AXFR requests from the following IP addresses:
220.127.116.11 18.104.22.168 22.214.171.124 126.96.36.199 188.8.131.52 2600:3c00::a 2600:3c01::a 2600:3c02::a 2600:3c03::a 2a01:7e00::a
Enter your domain name in the Domain field. An example is shown above.
Enter an administrator’s email address in the SOA Email field.
When you first create a domain zone, you’ll need to add some DNS records. This section explains how to add your own records.
Select a domain zone from within the Domains page. The following page appears:
The page is divided into different sections for each type of DNS record. Locate the section for the type of DNS record you want to add, then click Add a [DNS] Record.
NoteThe exact form fields will vary depending on the type of DNS record you select.
Enter a hostname in the Hostname field.
Enter the IP address of your server in the IP Address field. See this quick answer page to find your Linode’s IP address.
Select a time interval from the TTL menu. TTL stands for time to live, and affects how long DNS records are cached by DNS resolvers before the resolver must query the authoritative name servers for new records.
Click Save. It can take up to 30 minutes for new DNS records to become active.
You can also modify existing DNS records in the DNS Manager.
- Select a domain zone. The DNS records for the selected domain zone will appear.
Next to the DNS record you would like to edit, select Edit from the menu.
Edit the DNS record by modifying the existing values in the fields.
Click Save. It can take up to 30 minutes for the record to be updated.
Import Domain Zones with AXFR
If you’re migrating domains to Linode from another hosting provider and that provider allows zone transfers from its DNS server, it may be possible to import your existing domain zone and DNS records into the Linode Manager. If the import is successful, all of your existing DNS records will be available in the DNS Manager.
Here’s how to import a zone file:
Click on Import a Zone, from the Domains page.
Enter the domain name in the Domain field, as shown in the example above.
Enter the name server in the Remote Nameserver field.
The name server must allow zone transfers (AXFR) from:
184.108.40.206 220.127.116.11 2600:3c00::5e 2600:3c00::5f
Click Save. The Linode Manager will connect to the remote name server and import your existing DNS records.
Clone Domain Zones
The Clone a Zone feature allows you to copy DNS records from an existing domain zone in your account to a new zone. Assuming you’ve already set up DNS records for one domain name, this is a good way to quickly create DNS records for another domain name that will be hosted on your existing Linode.
Here’s how to clone an existing zone:
From the menu of the zone you would like to clone, select Clone.
Enter the name of the new zone in the New Domain field.
Click Create. The DNS records will then be copied from the existing zone to the new zone.
Check Domain Zones
Under normal circumstances, there’s no reason to suspect a problem with your domain zone or DNS records, but sometimes things go wrong. You can use the Check zone feature to verify that your domain zone is working correctly.
In order to check the status of your domain zone, from within the Domains section, select Check Zone under the menu to the right of your chosen domain zone. A page with the results of the domain zone check will appear.
If you see a message stating that your zone looks good, then everything is working correctly. Otherwise, check that all of the DNS records in your domain zone are properly configured.
View Domain Zones
The DNS Manager allows you to view the contents of a domain zone file. This is especially useful should you need to import the zone to a different server, or if you wish to inspect the file.
From the Domains section of your Linode Manager, select Zone file under the menu to the right of the chosen domain’s name. An example of the file is provided below.
Remove Domain Zones
If one of your domain names has expired or if you want to start hosting it on another DNS provider, you should permanently remove the domain zone and all of its associated DNS records.
Select Remove under the menu to the right of your chosen zone.
Click Remove to permanently delete the zone, including all associated records. It can take up to 30 minutes for the changes to be removed.
CautionOnce removed, you MUST delete the Linode nameserver entries from the domain at the registrar level. This is a very important step; if the entries are not removed, someone could use your domain without your permission.
To create a wildcard DNS record, add a new record and enter an asterisk (
*) in the Hostname field.
The Domains section does not support addition of a subdomain on top of an existing subdomain in the same zone. For example, if you have
example.com as a zone, with an A record for
subdomain.example.com, you cannot create
another.subdomain.example.com within that zone.
Instead, add the subdomain as a separate zone in the DNS Manager, and then create your additional subdomain as an A record. In the previous example, you would create a zone named
subdomain.example.com with a record with hostname
another inside of it.
To create a wildcard record on a subdomain (e.g.
*.subdomain.example.com), create a new zone for the subdomain and then add a wildcard record to it.
Having problems with your DNS records? We recommend reviewing this section to help get your DNS settings back on track. Follow these tips to troubleshoot DNS issues.
Wait for Propagation
DNS updates will take effect, or propagate, within the time period set by your zone file’s TTL. If you’ve just made a DNS change and aren’t seeing it reflected yet, the new information may not be reflected for up to 48 hours.
While you can’t control DNS caching at every point on the Internet, you do have control over your web browser. Try holding down the Shift key or the Control key (depending on your browser) while you refresh the page to bypass your browser’s cache of the old DNS data. You can also try bringing up your site in an alternate browser, or editing your hosts file to preview your website without DNS.
Set the Time To Live or TTL
In the context of DNS, Time to Live (TTL) tells internet servers how long to cache particular DNS entries. The default TTL for Linode zone files is 24 hours. This is fine for most situations because most people don’t update their IP addresses often.
However, there are times when you’ll want the TTL to be as low as possible. For instance, when you make a DNS change, you’ll want that change to propagate quickly. Otherwise, some people will see the new site right away, and others (who had the old data cached) will still be visiting the website at your old server. Long caching times can be even more problematic when it comes to email, because some messages will be sent to the new server and some to the old one.
The solution is to lower your TTL before making a DNS change. You’ll want to lower the TTL first, before making any other DNS changes. Here’s a general overview of what should happen during a smooth DNS update:
NoteTTL is always written out in seconds, so 24 hours = 86400 seconds.
- Check the TTL on your current zone file. Typically, this will be 24 or 48 hours.
- Update your current zone file 48 to 96 hours in advance (for a 24-48 hour record), taking into account any intermediate DNS servers. Lower the TTL to five minutes (300 seconds, or the lowest allowed value). Do not make any other changes at this time. If you’re using Linode’s Domains section, lower the TTL to 5 minutes for each entry you’re going to change.
- Wait out the original 48 to 96 hours.
- Visit your zone file again to update your IP address and anything else needed.
- The DNS changes should propagate within 30 minutes.
Find Current DNS Information
Sometimes you may need to find the current DNS information for a domain. There are two great tools for doing this:
dig: Look up individual DNS entries. For example, you can find the IP address where your domain resolves.
whois: Find your registrar and nameserver information for your domain.
If you’re using a computer that runs macOS or Linux, you can use these tools from the command line. To find your domain’s IP (the primary A record), run:
Look in the answer section of the output to locate your IP address. You can also query for other types of records. For example, to see the mail records for a domain, run:
dig mx example.com
This returns all of your domain’s MX records.
To find your domain’s registrar and nameserver information, run:
This generates a large amount of information about the domain. The basic information you need will be near the top of the output, so you might have to scroll back to see it.
For a web-based tool, you can also use kloth.net for dig requests and whois.net for WHOIS requests. Note that since you’re running these lookups from a third-party website, the information they find is not necessarily what your local computer has cached. There should be a difference only if you’ve made recent changes to your DNS information.
Join our Community
This guide is published under a CC BY-ND 4.0 license.