1 files changed, 35 insertions, 0 deletions
diff --git a/dns/README.md b/dns/README.md
new file mode 100644
index 0000000..87f0056
--- /dev/null
+++ b/dns/README.md
@@ -0,0 +1,35 @@
+Details of the DNS configuration for lain *(my homeserver)*.
+
+The files in this directory will allow you to spin up two instances of
+the BIND9 nameserver *(binary is "named")*
+
+These are configured for my IP addresses and domain names, but should
+act as a good template.
+
+If you have questions, feel free to reach out to me via contact info
+you have for me, or through [gen@nyble.dev](mailto:gen@nyble.dev).
+
+**configuration**  
+The server has two IP addresses provisioned to it. In this case, those
+are `192.168.88.27` as the "primary" address, and `192.168.88.53` as the
+"secondary" address that I only use for the local DNS server.
+
+***primary IP address***  
+For my configuration, this is `192.168.88.27`. This is the primary IP
+of the server and what I have my router port forwarded to pass tcp
+80/443 *(http/https)* and udp 53 *(dns)* to.
+
+This address is also what the public instance of BIND listens on. The
+associated files are `etc/named-public.conf`, the files in `var/named/`
+excluding the `private` subdirectory, and
+`etc/systemd/system/named-public.service`.
+
+***secondary IP address***  
+This IP is only used for local DNS resolution. It will do recursive
+resolution on my local network, `192.168.88.0/24`, and answer queries
+for the `my.dreamy.place` subdomain *(responding with the primary IP*
+*for `A` records, and the secondary IP for `NS` records)*
+
+Associated files are `etc/named-private.conf`, the files in
+`var/named/private/`, and the `etc/systemd/system/named-private.service`
+systemd service file.