Actually, when we release version 4.0 (and now if you run the
FTLDNS beta branch) you will be able to run
pihole-FTL and use that as your upstream resolved. I’ve been doing this for a while now.
There have been a good few guides pop up on the internet since cloudflare’s 184.108.40.206 launch on getting DoH working with pi-hole. For 4.0 (or
FTLDNS) you only need to follow them partially. Once you have got
cloudflared (or whatever alternative resolver you prefer) installed, you just need to add
[port] is the port your alt resolver is listening on e.g
5053) and you’re all set!
There are instructions in the guide for getting it to work on the current release version of Pi-hole, but they’re more of a workaround and not officially supported.
The relevant parts from this guide are as follows:
The installation is fairly straightforward, however be aware of what architecture you are installing on (
AMD64 architecture (most devices)
Download the installer package, then use apt-get to install the package along with any dependencies. Proceed to run the binary with the -v flag to check it is all working.
sudo apt-get install ./cloudflared-stable-linux-amd64.deb
ARM architecture (Raspberry Pi)
Here we are downloading the precompiled binary and copying it to the /usr/local/bin/ directory to allow execution by the cloudflared user. Proceed to run the binary with the -v flag to check it is all working.
tar -xvzf cloudflared-stable-linux-arm.tgz
cp ./cloudflared /usr/local/bin
chmod +x /usr/local/bin/cloudflared
Configuring cloudflared to run on startup
Create a cloudflared user to run the daemon.
sudo useradd -s /usr/sbin/nologin -r -M cloudflared
It is good practice to have a configuration file to contain options. Proceed to create a configuration file by copying the following in to /etc/default/cloudflared. This contains the command-line options that get passed to cloudflared on startup.
# Commandline args for cloudflared
CLOUDFLARED_OPTS=--port 5053 --upstream https://220.127.116.11/dns-query
Update the permissions for the configuration file and cloudflared binary to allow access for the cloudflared user
sudo chown cloudflared:cloudflared /etc/default/cloudflared
sudo chown cloudflared:cloudflared /usr/local/bin/cloudflared
Then create the systemd script by copying the following in to /lib/systemd/system/cloudflared.service. This will control the running of the service and allow it to run on startup.
Description=cloudflared DNS over HTTPS proxy
ExecStart=/usr/local/bin/cloudflared proxy-dns $CLOUDFLARED_OPTS
Enable the systemd service to run on startup, then start the service and check its status.
sudo systemctl enable cloudflared
sudo systemctl start cloudflared
sudo systemctl status cloudflared
Now test that it is working! Run the following dig command, a response should be returned similar to the one below
dig @127.0.0.1 -p 5053 google.com
; <<>> DiG 9.10.3-P4-Ubuntu <<>> @127.0.0.1 -p 5053 google.com
; (1 server found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 65181
;; flags: qr rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 1
;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 1536
;; QUESTION SECTION:
;google.com. IN A
;; ANSWER SECTION:
google.com. 299 IN A 243.65.127.221
;; Query time: 3 msec
;; SERVER: 127.0.0.1#5053(127.0.0.1)
;; MSG SIZE rcvd: 65