The Stupid Simple Guide to Setting Up Your Own DNS Server

By · Published · linux, networking

I'm a developer, first and foremost. I like writing code. To me, maintaining servers, configuring things, troubleshooting network issues and the like -  these are things I do to support my primary interest and job as a developer. I'm not ignorant of these things, but all things considered they're not my favorite things to do.

One thing I will admit I've been ignorant over the years is DNS. Oh sure, I know at a high level how it works. I even know a bit about the different record types. I knew enough to have my own domain name, configured using Godaddy's DNS servers to point to my server. But actually running my own name server? Something I've never done and, for some reason, had this unnatural fear of.

Well, no more. I'm now running my very own shiny new name server and, actually, it wasn't really as difficult as I thought. And because this was a learning experience for me, I figured I'd walk you through what I did as well.

Picking  a Server

There are two big players in the "DNS Server software" space: BIND and djbdns. BIND is the 900 pound gorilla that has been around forever and ever, and is insanely difficult to configure. djbdns is from the same guy who wrote qmail - I'll let you be the judge of that. But after researching and actually attempting to install both of these, I eventually gave up. Both just came across as being too complex for a simple name server handling a couple of domains, and the documentation for both was equally complex.

That's when someone on Twitter pointed me to MaraDNS. I looked it over and was surprised to find good, readable and simple documentation that made it look easy to install. So I decided to give it a whirl. Here's what I did. Note that this install is for a Gentoo system. Yours will be different if you're using something else.

Installing and Configuring MaraDNS

First step is to install it.

emerge maradns

And let Portage do its thing. Once it's installed, you really only have to worry about a few files. In /etc/mararc, you need to check to be sure you're binding to the right interfaces. In my config, I bound it to the loopback and to the main interface:

ipv4_bind_addresses = "x.x.x.x, 127.0.0."

After that, you tell it to be authoritative, and what domains you are wanting to serve records for.

csv2 = {}
csv2[""] = "zones/"

Note the period at the end of the domain name - it's important. Each entry in the csv2 array should map to a zone file. I put mine in the "zones" subdirectory (which, in Gentoo, lives under /etc/maradns).

mkdir -p /etc/maradns/zones

Then, with your favorite editor (which should be vi :P), you create your zone file. The one for (partially) looks like this:       NS       NS +3600 A x.x.x.x +3600 MX 0 +3600 CNAME

So what are we doing here? Well, here it helps to know something about the different types of DNS records. I'm not going to cover all the different types of records - this is a good list of common ones and Wikipedia has a full list. The important ones you need to know are NS (Name Server), A (the main record), MX (mail server records), and CNAME (alias). The "+3600" is setting a timeout on the records to one hour (3,600 seconds). By default, the server will send one day (86,400 seconds).

Here, I'm telling the server what the name servers are (strictly speaking, this isn't required, but I added it all the same) and that the main address for people requesting "" is this IP address. I'm also saying that people who request "" should get the IP address for "" I also add an MX record that points to with 0 as the priority (the first (and only) server).

That's it! Restart MaraDNS:

/etc/init.d/maradns restart

And you can test it out.

dig @localhost A

You should get a big long printout, but what you want to see is these two lines:

QUERY: 1, ANSWER: 1, AUTHORITY: 2, ADDITIONAL: 0 3600 IN A x.x.x.x

Assuming the above is the correct address, congratulations, your DNS server is now resolving properly locally.

Delegating your Domain

The next step is delegating your domain to your own server. I'm not going to cover this in too much detail because how it happens depends on the registrar. In general, this is a two step process:

  1. Register your name server's IP address to a name. At NameCheap, when you're in the domain screen this is done under Advanced Options > Nameserver Registration. Under GoDaddy, this is under the "Hosts" section of the domain information screen. You need to add at least two "" entries, but they can both point to the same IP.

  2. Delegate your domain to the names you just created. At NameCheap, you would go General > Domain Name Server setup, and Specify Custom DNS Servers. Then, enter the two (or more) names you just created "". I can't remember how I did this in GoDaddy, but I remember it was pretty apparent.

That's it! They say it takes 24-48 hours, but I started seeing requests hit the new name server within about an hour. Of course, since I wasn't actually changing IP addresses, there was no real downtime.


As of now, all my domains are being served off my own nameserver. It's kind of a neat feeling of accomplishment, knowing you're not relying on someone else's DNS setup - they're just providing you a name. This makes domain transferring much easier and adding new records much easier. And seeing as how I'm currently in the process of transferring all my domains away from GoDaddy, this will ease the transition.

( Comments )

Did something I wrote help you out?

That's great! I don't earn any money from this site - I run no ads, sell no products and participate in no affiliate programs. I do this solely because it's fun; I enjoy writing and sharing what I learn.

All the same, if you found this article helpful and want to show your appreciation, here's my wishlist.

Related Posts

Options Have Meanings, or, How I Made an rsync Seven Times Faster

Automatically Provisioning Polycom Phones

comments powered by Disqus