DockNS

Appearance

Technitium DNS Configuration ​

HEAD'S UP

If you haven't read the primer on name server configuration, you should read that first as this page builds on the information presented there.

What is Technitium DNS? ​

Technitium DNS is a self-hostable DNS server which can do recursive resolving as well as act as an authoritative name server and block ads at a network level. It focuses on compliance with DNS RFCs while still being user friendly.

Fields ​

host string required ​

The host field is the URL at which to connect to your Technitium instance's web interface.

Example:

toml
[name_servers.technitium_server]
service = "technitium"
host = "http://192.168.1.60:5380"
api_key = "<api key>"
bash
DOCKNS_NS_TECHNITIUM_SERVER_SERVICE=technitium
DOCKNS_NS_TECHNITIUM_SERVER_HOST=http://192.168.1.60:5380
DOCKNS_NS_TECHNITIUM_SERVER_API_KEY=<api key>

api_key string required ​

To obtain an API key for your Technitium server, login to the web portal and navigate to "Administration" > "Users". Create a user with whatever name and password you want, we recommend "dockns" to make the user's purpose obvious.

Select the user from the "Users" menu and add it to the DNS Administrators group with the "Add Group" drop down. Be sure to save the changes.

Next, go to "Administration" > "Sessions" and click the "Create token" button. Select your new user in the "Username" drop down and give the token whatever name you like.

Copy the new token into your config.toml or set the DOCKNS_NS_<SERVER ID>_API_KEY environment variable.