[Show and Tell] Pi-hole Ultimate Installation Suite: Full recursive DNS stack with Thermal Monitoring & Auto-Backups

Hello Pi-hole Community,

I wanted to share a project I’ve been refining for the Raspberry Pi and Debian community: Pi-hole Ultimate Installation Suite (v1.4.8).

The goal of this script is to provide a "one-command" deployment for a hardened, high-performance privacy stack that is 100% persistent across reboots and power outages.

:building_construction: The Stack

The script automates the installation and complex configuration of:

  • Pi-hole: Network-wide ad-blocking.

  • Unbound: Configured as a local recursive DNS resolver (no upstream leaks).

  • DNSCrypt-Proxy: Secondary encrypted failover for ultimate privacy.

  • WireGuard: Secure remote access to your DNS stack.

:glowing_star: Key "Set-and-Forget" Features:

  • Dynamic Port Persistence: Automatically detects and saves available ports for DNSCrypt to prevent service conflicts on reboot.

  • Thermal Monitoring: A built-in background service that logs CPU temps and alerts you at 75°C/80°C (critical for headless Pi 4/5 setups).

  • Automated Backups: Weekly cron-scheduled Teleporter backups with a 7-day retention policy.

  • Static IP Reinforcement: Automatically detects your active interface (Eth/WiFi) and locks the IP to prevent "DNS blackouts" after router restarts.

  • D-Bus & Service Repair: Auto-fixes common Debian/Pi-OS system message bus issues before the final reboot.

:rocket: Why I built this:

I noticed many users struggle with the manual "piping" required to get Unbound and DNSCrypt working perfectly with Pi-hole's setupVars.conf. This script handles the strict-order and no-resolv hardening automatically to ensure no leaks to your ISP.

:hammer_and_wrench: Installation:

Bash

curl -sSL https://raw.githubusercontent.com/waelisa/pi-hole-full-Installation-with-dns/main/pihole-auto-installation-with-dns.sh | sudo bash

I’d love to hear your thoughts, especially regarding the thermal monitoring logic and the Unbound configuration parameters I've chosen.

GitHub Repository: https://github.com/waelisa/pi-hole-full-Installation-with-dns

Thanks for the amazing work on Pi-hole!

Just Curious, I’m running a caddy server and no-ip (Dynamic DNS) solution for a specific home hosted server. So how will the reverse proxy (caddy) play with your set up regarding leaking to the ISP? should I sub-net these, or does that even matter?

Hi, will this setup work on raspberry pi zero 2w?

My script help for local network static ip, i dont caddy server sorry.

Yes, why not!

Hi waelisa , I have tried running your script about 3 times now and it fails at installing pi-hole step 6 /13. I have no idea why. Can you help

Issues with waelisa's third-party script should be tracked and discussed at their GitHub project at GitHub: waelisa » Issues.

open issue here

with upload /var/log/pihole-ultimate-install.log