This is the first blog post in our new series, Tips and Tricks.

Cloudflare’s new DNS service has a lot of industry attention, so we wanted to offer a quick guide that covers setting up your DNS servers in pfSense®, including configuring DNS over TLS. In addition to Cloudflare DNS servers, the following guide also applies to Quad9 DNS service.

Thanks to Unbound, the built-in DNS resolver, which has been enabled by default since pfSense version 2.3, makes configuring DNS over TLS a very simple task with pfSense.

Note: This guide applies only to DNS resolver. Forwarding mode must be disabled in the DNS resolver settings, since the example below defines its own forwarding zone.

Step 1

The first step ensure Cloudflare DNS servers are used even if the DNS queries are not sent over TLS (step 2). Navigate to System > General Settings and under DNS servers add IP addresses for Cloudflare DNS servers and select your WAN gateway.

Screen shot for DNS Server Settings

After entering the DNS IP addresses, scroll down to the bottom of the page and click Save. Your pfSense appliance is now using Cloudflare servers as DNS.

Step 2

To configure the DNS resolver to send DNS queries over TLS, navigate to Services > DNS Resolver and on the tab General Settings scroll down to the Custom Options box. Enter the following lines (you should be able to simply copy / paste the section text block below):

name: "."
forward-ssl-upstream: yes

To use Quad9 DNS servers instead of, or in addition to, the Cloudflare servers, change or add the following forward-addr entries in the Custom Options example above:


Feel free to mix and match the servers, you can add as many as you like, and using multiple DNS providers can help prevent an upstream outage from causing loss of DNS resolution on the firewall.

Click Save and you’re done! Your pfSense appliance is now sending DNS queries to Cloudflare DNS servers over TLS.

You can confirm if DNS queries are being sent over TLS by performing a packet capture on the WAN interface.

We’re using IPv4 in this guide, however Cloudflare and Quad9 also offer their DNS service for IPv6 networks. The steps in this guide should still apply if you’re using IPv6. Find the IPv6 addresses Cloudflare offers here or Quad9 IPv6 addresses here.

This feature will be available as a GUI option in pfSense 2.4.4, and at that time the custom options can be removed.

That’s it for our first Tips and Tricks! There will be more posts coming soon about our appliances, software development, training, and much more.