Installation

Building

To get atomdns you have to build it from source. We have not yet distribute packages for the different OSes.

Prebuild Binaries

TODO

https://codeberg.org/miekg/dns/issues/436

Linux Distribution Packages

TODO

https://codeberg.org/miekg/dns/issues/437

Building From Source

If you don’t have Go, or not the latest version of Go, following the Go installation guide.

Once you have working go binary, you clone the atomdns repository and use “go build” to build the binary.

  1. mkdir src; cd src
  2. git clone https://codeberg.org/miekg/dns
  3. cd dns/cmd/atomdns
  4. go build

If you want a fully static binary use CGO_ENABLED=0 go build.

Testing

This should have yielded a atomdns binary. Check for instance the version and list all compiled handlers.

./atomdns -V
041

Or

./atomdns -H
acl
any
as112
chaos
cookie
dbfile
dbhost
dbsqlite
drunk
geoip
log
metrics
nsid
refuse
sign
template
unpack
url
whoami
yes
Info

If you have the source in the man directory you can find all manual pages. On Linux you can just man man/atomdns-.... to read a manual page.

Next we continue with the configuration.