Stubby is the name given to a mode of using getdns which enables it to act as a local DNS Privacy stub resolver (using DNS-over-TLS). Stubby encrypts DNS queries sent from a client machine (desktop or laptop) to a DNS Privacy resolver increasing end user privacy. Stubby is in the early stages of development but is suitable for technical/advanced users. A more generally user-friendly version is on the way!
It is recommended to use the latest release of the 1.1 version of getdns to have the most up to date version of Stubby.
In this mode Stubby (getdns) does several things
In this mode, the only dependency is OpenSSL (version 1.0.2 or later is required for hostname authentication to be supported). If this is installed in a non-standard location on your system use the --with-ssl option to configure below to specify where it is.
It may be necessary to install 1.0.2 from source for most Linux distros.
It is recommended to install OpenSSL using homebrew, in which case use the following in the configure line in step 1.3 below:
Download the getdns source
Either clone the code:
or grab a tarball from this page: Latest getdns releases
Build the code
Create a config file
Stubby will use the config file at /etc/stubby.conf by default if it exists, or the config file location can be specified on the command line using the '-C' flag. [Note: With no config file stubby will use UDP to the default nameservers for queries).
To hand-craft a config file, read the instructions below. Changes to the config file require a restart of Stubby.
The config file below is an example that will configure Stubby to:
Additional privacy servers can be specified by adding more entries to the upstream_recursive_servers list above (note a separate entry must be made for the IPv4 and IPv6 addresses of a given server. More DNS Privacy test servers are listed here.
A custom port can be specified by adding the 'tls_port:' attribute to the upstream_recursive_server in the config file.
Simply invoke Stubby on the command line. By default it runs in the foreground, the '-g' flag runs it in the background. The pid file is /var/run/stubby.pid
A quick test can be done by using dig (or your favourite DNS tool) on the loopback address
Modify your upstream resolvers
For Stubby to re-send outgoing DNS queries over TLS the recursive resolvers configured on your machine must be changed to send all the local queries to the loopback interface on which Stubby is listening. This depends on the operating system being run. It is useful to note your existing default nameservers before making this change!
From the command line you can do the following to set the local DNS servers on, for example, your 'Wi-Fi' interface (first line clears all servers, second line adds localhost):
If you want to reset, just use:
which should pick up the default DHCP nameservers. Or use something similar to the first set of instructions if you want to specify particular namerservers.
Or via the GUI: