archdiocese-of-new-orleans/docker-tinytinydns

DJB's tiny DNS nameserver, Dockerized

docker-tinytinydns

A very tiny Docker image that runs D. J. Bernstein's tinydns authoritative DNS server. At a virtual size of 33kB (yes, kilobytes), it's quite a lot smaller than your average BIND Docker image, although, admittedly, it doesn't have all of BIND's features.

IMPORTANT

This version will scp the data & data.cdb to the REMOTE_HOST and REMOTE_DATA_PATH you specify. You'll need to setup ssh authorized_hosts on the other end beforehand.

What's included?

• tinydns version 1.05.

That's it.

How do I use it?

# on the docker host which contains your primary nameserver
git clone https://github.com/Archdiocese-of-New-Orleans/docker-tinytinydns.git

Write a tinydns data file, turn it into a data.cdb and scp to REMOTE_HOST:REMOTE_DATA_PATH database with:

cd docker-tinytinydns
[email protected] REMOTE_DATA_PATH=/remote/data/path make

Then do (on both docker hosts that contain primary and remote nameservers):

docker run -d -p 53:53/udp -v /host/path/to/data.cdb:/data/data.cdb --restart=always archno/docker-tinytinydns

tinydns should start serving DNS requests on port 53 and print its log to standard out.

An example data file (and its corresponding data.cdb file) have been included in the repository for your perusal.

License

The tinydns programs are part of djbdns which has been placed into the public domain by the author. I dedicate the rest of it to the public domain under CC0.