Installing ubound on a Raspberry Pi
/etc/hosts file to add a IP to receive queries to ubound by running
sudo nano /etc/hosts and adding host e.g.
127.0.0.11 for ubound
127.0.0.1 localhost 127.0.1.1 DietPi ::1 localhost ip6-localhost ip6-loopback ff02::1 ip6-allnodes ff02::2 ip6-allrouters 127.0.0.11 ubound
Download and install required files:
sudo apt install unbound # Updated every 6 months (Jan & July) wget -O root.hints https://www.internic.net/domain/named.root sudo mv root.hints /var/lib/unbound/ sudo nano /etc/unbound/unbound.conf.d/pi-hole.conf
Now paste the following text:
server: # If no logfile is specified, syslog is used # logfile: "/var/log/unbound/unbound.log" verbosity: 0 ip-address: 127.0.0.11 port: 5353 do-ip4: yes do-udp: yes do-tcp: yes # May be set to yes if you have IPv6 connectivity do-ip6: no # Use this only when you downloaded the list of primary root servers! root-hints: "/var/lib/unbound/root.hints" # Trust glue only if it is within the servers authority harden-glue: yes # Require DNSSEC data for trust-anchored zones, if such data is absent, the zone becomes BOGUS harden-dnssec-stripped: yes # Don't use Capitalization randomization as it known to cause DNSSEC issues sometimes # see https://discourse.pi-hole.net/t/unbound-stubby-or-dnscrypt-proxy/9378 for further details use-caps-for-id: no # Reduce EDNS reassembly buffer size. # Suggested by the unbound man page to reduce fragmentation reassembly problems edns-buffer-size: 1472 # Perform prefetching of close to expired message cache entries # This only applies to domains that have been frequently queried prefetch: yes # One thread should be sufficient, can be increased on beefy machines. In reality for most users running on small networks or on a single machine it should be unnecessary to seek performance enhancement by increasing num-threads above 1. num-threads: 1 # Ensure kernel buffer is large enough to not lose messages in traffic spikes so-rcvbuf: 1m # Ensure privacy of local IP ranges private-address: 192.168.0.0/16 private-address: 169.254.0.0/16 private-address: 172.16.0.0/12 private-address: 10.0.0.0/8 private-address: fd00::/8 private-address: fe80::/10
Now create the ubound.conf file to
/etc/unbound/unbound.conf. Create the file by:
sudo nano /etc/unbound/unbound.conf
Then paste the following lines:
# Unbound configuration file for Debian. # # See the unbound.conf(5) man page. # # See /usr/share/doc/unbound/examples/unbound.conf for a commented # reference config file. # # The following line includes additional configuration files from the # /etc/unbound/unbound.conf.d directory. include: "/etc/unbound/unbound.conf.d/*.conf"
unbound server and test:
sudo service unbound start dig pi-hole.net @127.0.0.11 -p 5353
If you have enabled DNSSEC you can check by:
# FAIL test dig sigfail.verteiltesysteme.net @127.0.0.11 -p 5353 # OK test dig sigok.verteiltesysteme.net @127.0.0.11 -p 5353
Now set the PI hole custom DNS to
127.0.0.11#5353 and hit ==Save== on the DNS settings page of Pihole.
Updating to 1.9.6
Found from pihole discourse.
sudo apt install build-essential openssl libssl-dev libexpat1-dev bison git clone https://github.com/NLnetLabs/unbound.git cd unbound git checkout release-1.9.6 ./configure --prefix=/usr --includedir=/usr/include --mandir=/usr/share/man --infodir=/usr/share/info --sysconfdir=/etc --localstatedir=/var --disable-rpath --with-pidfile=/run/unbound.pid --with-rootkey-file=/var/lib/unbound/root.key --enable-subnet --with-chroot-dir= --libdir=/usr/lib make ./unbound -v # To check if it compiled correctly sudo service unbound stop sudo make install sudo service unbound start # If the above command doesn't work check sudo /usr/sbin/unbound -ddd -vvv -c /etc/unbound/unbound.conf # Check if Unbound is working or not dig pi-hole.net @127.0.0.11 -p 5353 # Check unbound version unbound -v dig +short @127.0.0.11 -p 5353 chaos txt version.bind sudo reboot #check again if unbound works or not
Now disable auto-update or overwrting by default debian releases.
sudo tee /etc/apt/preferences.d/unbound <<< $'Package: unbound\nPin: release *\nPin-Priority: -1' sudo apt update apt policy unbound