DNSCrypt-proxy encrypts DNS queries that would otherwise go in plaintext ensuring that they won’t be seen or modified by anyone in the middle. It works as a localhost DNS server sending queries to configured DNS resolvers.

I guess I should also say why you would want dnscrypt v1 vs v2. V1 which is in most of repos currently uses broken resolver by default and only supports one resolver at a time, while v2 can use multiple of them while comparing them for the best ones.

This post is on getting v2 to Debian Stable and Ubuntu pre 18.10 which contain v1 and I (sadly) don’t know a better way to do this.

In order to check which version your distro has available, check the dnscrypt-proxy search page for your distribution:

  • Debian
    • 2018-11-03: the version in stretch (stable) is 1.9.4-1 which has the issues why I wrote this post.
  • Ubuntu
    • 2018-11-03: I cannot find dnscrypt-proxy from Ubuntu at all, while I am sure it previously had the Debian version 1.

  1. Update your local apt cache sudo apt update and install curl that will be used for downloading the package from Debian sudo apt-get install curl

Check the version number at Debian’s dnscrypt-proxy package download page and fix it below:

2: download the packagecurl -LO https://deb.debian.org/debian/pool/main/d/dnscrypt-proxy/dnscrypt-proxy_2.0.16-2_amd64.deb

WARNING: This part is not supported by either Debian or Ubuntu, you are taking a package from another distribution and attempting to install it on another.

WARNING: Usually when you use apt, it will verify package signatures and ensure that the package hasn’t been tampered with. I have no idea how to do that with direct downloads (if it’s even possible) so you will be trusting the Debian repository mirror or CDN blindly.

  1. install the package you downloaded: sudo dpkg -i dnscrypt-proxy<TAB> (TAB (above capslock) automatically completes rest of the filename for you).
    1. In case there was a problem, attmept sudo apt-get install -f to fix broken package depedencies. Remember to check that what it suggests looks reasonable! If it asks to remove dnscrypt-proxy, you are out of luck and should do that instead of attempting to replace important system components from another distribution (creating “Frankendebian”).

Hopefully dnscrypt-proxy is now running, check journalctl -u dnscrypt-proxy, there should be a line saying [NOTICE] Wiring systemd TCP socket #0, dnscrypt-proxy.socket,

Edit /etc/NetworkManager/NetworkManager.conf to avoid overlapping resolvers breaking each other, it should say say dns=none e.g.:


if it doesn’t say dns=none, fix it and restart it with: systemctl restart NetworkManager

Edit your /etc/resolv.conf, for example:

sudo su -
rm /etc/resolv.conf
nano /etc/resolv.conf && chattr +i /etc/resolv.conf

chattr +i will prevent modifying the file unless chattr -i is done first.

Example resolv.conf:

options edns0 single-request-reopen
#search mikaela.info

Nameserver is the host where dnscrypt-proxy said to be listening on in journalctl, options are from dnscrypt-proxy documentation and search means domains that are automatically searched for if you don’t use fully qualified domain names, e.g. ssh machine in my (uncommented) config would turn into ssh machine.mikaela.info.

You should also tell dhclient to not touch resolv.conf or you may get many files into /etc beginning with names resolv.conf.dhclient-new. according to Debian wiki which gives the following two commands and Debian bug 860928:

echo 'make_resolv_conf() { :; }' > /etc/dhcp/dhclient-enter-hooks.d/leave_my_resolv_conf_alone
chmod 755 /etc/dhcp/dhclient-enter-hooks.d/leave_my_resolv_conf_alone

For the curious my dnscrypt-proxy config: https://github.com/Mikaela/shell-things/tree/master/etc/dnscrypt-proxy