Sam Breed

Product Developer, Investor

Protect your DNS history with DNSCrypt

DNSCrypt is a great way to ensure that your browsing history isn't being spyed on. Learn how to set up DNSCrypt to keep your DNS traffic from prying eyes.

Protect your DNS history with DNSCrypt

In light of the recent rollback(s) of regulations meant to restrict how ISP’s share and sell the data they gather about you, I started wondering what I could do to make my internet traffic a bit harder for them to monetize. How would I prevent my ISP from selling details about my shopping habits and personal preferences to the highest bidder?

Or skip straight to how to do it.

Why DNS and why should you care?

Standards for encrypting web traffic have become widely adopted since their introduction in the late 90s. It’s not my first day, so I knew that content sent over HTTPS would be difficult (but not impossible) for a third party to do much with, and I already use HTTPS-everywhere and Brave to help keep things on the up-and-up. Unfortunately, even exclusively using HTTPS doesn’t mean that 100% of your traffic is encrypted and secure.

A crucially important part of how your computer or phone loads a website is completely unencrypted in practice. The Domain Name System, or DNS, is how your web browser knows how to find the domain “” when you type into your browser’s address bar, and DNS isn’t normally encrypted. Anyone who handles the traffic can take a peek if they’re so inclined.

Ability plus incentive makes for easy temptation. DNS is an easy target if your ISP wanted to profit from a complete list of the websites you visited.

Even worse, an ISP could resolve a DNS entry for a different website altogether or send you to a “toll booth” captive portal for whatever nefarious reasons they could think of.

Which means that even if I took every reasonable precaution and always made sure https was in the URL when buying John Tesh cd’s on Amazon, watching John Tesh videos on Youtube, or posting updates to my John Tesh fanzine, Comcast would still be able to see the URLs of the pages and sell them to anyone who cared. That is unacceptable. My secret love of John Tesh is too precious for a greedy corporate entity to harvest for profits.

Good thing for me, a bunch of smart folks who are well versed in “the cyber” had already thought this one through enough to write RFC standards for the DNS protocol that can make it much harder for a third party to see the paper trail of domains and URLs left by a furious session of John Tesh related browsing. Even better, these standards have been implemented with open source and are available to use for free, without too much overhead.

Unfortunately, encrypting your DNS isn’t yet as ubiquitous or widely support as HTTPS, so there are still a few hoops to jump through if you want to start obfuscating this aspect of your web traffic.

It’s also important to note that encrypting your DNS isn’t a silver bullet with regards to online privacy. True privacy is a fleeting concept, or at least one that’s impossible to make sane guarantees about. Like any encryption technology, it’s only as strong as the implementation being used, and in recent years those have been known to be compromised with some degree of regularity. Even when you’re encrypting your communications doesn’t mean you should automatically trust the person on the other end of the line. Not to sound paranoid, but be careful about who you place blind trust in and always look before you leap.

Enter DNSCrypt

DNSCrypt is a great collection of software tools that let you get up and running with encrypted DNS really quickly. Don’t take my word of it. Head over to for comprehensive info about what it is and all the ways you can use it.

dnscrypt + httpseverywhere is 9/10s of a vpn imo

Alex Sexton, notable person on the internet

DNSCrypt is a way to run an encrypted dns server and clients for every platform to connect with it. There are already plenty of servers around the world that you can connect to out-of-the-box with a gui clients, so getting up and running is super easy. And there are plenty of command line tools, too. Everything is open source and the community seems active, with multiple projects to choose from for most layers of tooling.

The client apps work by changing your network settings to use a dns server running DNSCrypt, and lets you quickly switch back and forth between your previous “normal” dns and an encrypted configuration. It does this by running a local dns server on your computer, which handles one end of the encryption and decryption, with the public server you’re connecting with on the other end. Since all the traffic is encrypted on your computer before it’s sent to the server, an intermediary like your ISP can’t see the domain being requested.

What’s the catch? Why isn’t this everywhere already?

The catch is that ultimately your dns request will be served from an unencrypted (but authenticated) channel because the global network of DNS servers does not implement the DNSCrypt protocol.

First steps

Better instructions here:

Install the dnscrypt-client and connect to one of the public nodes. I chose You can “trust” these because they issue keypairs or something(?) but, caveat emptor.

But roll with the thick client because it’s convenient and you’ll get to see what you’re in for… which is pretty boring if you’re not running dig or nslookup all the time to see where your DNS entries are coming from. But then again, it’s pretty boring. But at least they’re encrypted?

Paranoid mode: Roll your own DNSCrypt server

I chose a droplet that came with Ubuntu 16.04 and Docker 1.17 pre-installed. Created a new keypair (always, always create a new keypair) and give it a good name, a static IPv4 address, and an IPv6 address if you hate yourself (or want to learn about docker’s nightmare factory networking layer).

SSH to the server and fire up the DNSCrypt Server Docker Image with the instructions from the README:

docker run --name=dnscrypt-server -p 443:443/udp -p 443:443/tcp \
    jedisct1/unbound-dnscrypt-server init -N

docker start dnscrypt

The first command returns a public key. You’ll need this. It’s also in your docker logs if you forget it docker logs dnscrypt-server | head.

Now you have a server running, note the IP and setup a client to connect to it.

Connecting clients with dnscrypt-proxy

I tried 2 ways of connecting devices to my new dnscrypt server from my local network.

1 - Run the proxy client everywhere

Run dnscrypt-proxy on every device where you want encrypted dns, which makes a local dns server which sends encrypted requests to your server. This is the “safest” way of doing things because you’re not trusting anyone else to do the encryption for you, making it a bit more difficult for someone to spy on your dns traffic.

Install it for mac with homebrew: brew install dnscrypt-proxy

Then connect to your server using the IP and public key:

sudo dnscrypt-proxy --provider-key=YOUR_PUBLIC_KEY \
  --resolver-address=YOUR_IPv4_ADDRESS:443 \

Now edit your DNS settings to point at your IP. This is actually really convenient if you’re already using dnscrypt-client: in the “Advanced” tab, add your IP to the field labeled “When not using DNSCrypt, use the following static DNS servers”. Now, when you turn off the DNSCrypt thick client, it will try to use the proxy you started from the command line.

It’s a pain in the ass that you can’t point to your own server on the client. There, I said it. Pull requests welcome, I guess?

2 - Run it from one place on your local network

Run dnscrypt-proxy somewhere on your local network, and tell devices to use that as their source of truth for dns. If you trust your local network (which, depending on how many IOT devices you have running or you don’t control router/modem settings, might not be a good idea,) then you can avoid extra process overhead and it works for phones and tablets.

Basically the same steps as above, but make sure that you start the dnscrypt-proxy client with --local-address= so that it broadcasts to your network.

And, uh, make sure your router doesn’t liberally port forward or you’ll live to regret it.

I did this on my ubuntu media server and I ran into dnsmasq issues, because ubuntu is stupid and runs a dnsmasq process as part of it’s network stack, but it’s not the “real” dnsmasq so you can’t configure it to broadcast (go figure).

To get everything working without just nuking the unconfigurable dnsmasq process, I had to run dnscrypt-proxy on another port, and then install the “real” dnsmasq, sudo apt-get install dnsmasq and tell it to use dnscrypt-proxy as a nameserver. All this is from here, conveniently:


Then I switched all the dns settings on my phones and computers to point at the local ip of my media server for DNS, falling back to google’s and to avoid being inconveninced if the process dies.


Encrypting DNS is boring, but satisfying.

Happy Hacking 🤓

→ Reply