User Mod [THEME] Pi-hole Lizard Theme
A dark theme for the Pi-hole v6 web interface (Syne + JetBrains Mono), with an installer that survives Pi-hole updates.
Version: 1.2.0 · Tested with: pi-hole/web master, commit fb699c4 (2026-10-17), Chart.js 4.5.1
Github: https://github.com/hbrtkp/pihole-lizard-theme
If you like this theme and want to say thanks, you can buy me a coffee: PayPal · buycoffee.to
What you get
- dark panel with boxes, a status panel with CPU temperature and blocklist age,
- dashboard statistics in one box, smooth charts,
- no top bar and no footer: "Toggle menu", "Log out" and the Pi-hole versions live at the bottom of the sidebar,
- a Dark / Light switch at the bottom of the sidebar; the light side uses one of five palettes — paper (default), sand, mint, slate, contrast,
- the theme comes back by itself after the Sunday Pi-hole update and after a reboot.
Nothing about DNS, blocking or security is touched — the theme only changes the look of http://pi.hole/admin.
Install
On the Pi (git is needed once: sudo apt install -y git):
git clone https://github.com/hbrtkp/pihole-lizard-theme.git
sudo bash ~/pihole-lizard-theme/pihole-theme.sh installThen Ctrl+F5 in the browser on http://pi.hole/admin.
Check
sudo pihole-theme doctorThe last line must read Result: errors=0, warnings=.... Lines marked [FAIL] say what to do. Run it whenever the panel looks wrong, e.g. after a Pi-hole update.
If the panel still looks stock after an update you started by hand (pihole -up):
sudo pihole-theme reapplyLight palette
The switch remembers the choice per browser. Which light palette it uses is set once on the Pi:
sudo pihole-theme set light sand # paper | sand | mint | slate | contrastUpdate the theme
cd ~/pihole-lizard-theme && git pull
sudo bash pihole-theme.sh install
sudo pihole-theme doctorUninstall
sudo pihole-theme restore # original Pi-hole look, cron job and command removed
sudo rm -rf /opt/pihole-theme ~/pihole-lizard-theme # files and settings, downloaded copyThen Ctrl+F5 in the browser. The system is back to the state before the installation.


