How do I revert to a previous version of Pi-hole?



if you want to run a different version of Pi-hole, it is possible to install an older version. Typically, we release all three components of Pi-hole at the same time (Core, Web, and FTL), so you’ll usually want to install version from the same “release.”

For example, we ran into some issues with v3.3 and dnsmasq compatibility with some systems, so some users needed to revert to v3.2.1 (Core and Web) but as part of the 3.2.1 “release,” the latest version of FTL was 2.13.2.

Because we version each component of Pi-hole separately, you can checkout each version. The important thing to note is that you need to checkout FTL last because pihole -r tries to download the latest FTL.

So to revert to the 3.2.1 “release,”:

cd /etc/.pihole
sudo git fetch --tags
sudo git checkout v3.2.1
cd /var/www/html/admin
sudo git fetch --tags
sudo git checkout v3.2.1
pihole -r
pihole checkout ftl v2.13.2

EDIT: 2018/02/07

If you had previously downloaded the v3.3 release, you may now have an extra line in your /etc/dnsmasq.d/01-pihole.conf, remove the line log-queries=extra as earlier versions of dnsmasq can not utilize the extra logging capabilities.

Dnsmasq fails on Pi-hole 3.3
Error: Unable to get latest release location from GitHub
Pi-hole v3.3 Released: It's "Extra" Special
Error: Unable to get latest release location from GitHub
Query Log Wont Populate
Pihole not able to access internet
No Data on dashboard
Services won’t start after upgrade
Pihole Start up Issues
Dnsmasq Service Failing - PiHole not working
Update Failed - Please contact pihole
Issue installing pihole
Unable to use pihole on raspbian 8
Empty /etc/pihole after re install
403 - Forbidden after install
PiHole configured as DNS + DHCP and has internet access, but no traffic logged in web console
PiHole configured as DNS + DHCP and has internet access, but no traffic logged in web console
FTL is offline, but pihole works
Raspbian jessie issues, not logging, no graphs, have to restart ftl service
Dnsmasq startet nicht - Grund 01-pihole.conf -> log-queries=extra | Token zgpnrjzunw
Help Us Beta Test FTLDNS™
New install of 3.3 doesn't seem to be actually filtereing
Admin page returns 403 Forbidden; new install
Lost Connection to API - FTL Offline
Installation stopped
Why can't I run Pi-hole v3.3+ on Raspbian Jessie or with dnsmasq < v2.72?
Frustrating fresh pihole installation, no internet
Pi hole not blocking on synology nas
Issue with DNSMasq
FTLDNS™: Pi-hole's Own DNS/DHCP server
Fresh install, DNS/FTP not running/offline
Getting pi-hole to start working
Dnsmasq to old!
Web interface showing no stats
FTL issue on new install
Pihole not blocking ads in adlists.list
Pi-hole showing zero clients, zero ads blocked yet pihole -t shows active connections
So Long Pihole

I appreciate the instructions on how to revert to a previous version. I had to do this after the most recent release because the Pi-hole dnsmasq stopped working. Since then, I have updated my OS (jessie) and would like to update to the latest version of Pi-hole again. However, because the Head is detached at v3.2.1 it will not update. Is there a set of commands that will allow me to update the latest version again? Here is what shows on the bottom of the Pi-hole Console page: Pi-hole Version vDev (HEAD, v3.2.1-0-ge602008) Web Interface Version vDev (HEAD, v3.2.1-0-g31dddd8) FTL Version vDev (v2.13.2, v2.13.2) Thanks!


You can switch back to the master branch with sudo git checkout master (instead of the sudo git checkout v3.2.1)

Afterwards I could update it to latest version. (maybe you run into this Updated to v3.3; web UI thinks CORE still at v3.2.1)

Pihole not able to access internet

I tried what the OP suggested for downgrading Pi-Hole but I get this error whenever I run the checkout commands

error: pathspec ‘v3.2.1’ did not match any file(s) known to git.


Okay I found the solution!

First you have to run sudo git fetch --tags before the checkout commands.


I have followed the instructions to go from 3.3 to 3.2.1 and it works! Got my pi-hole working again!

I did not have to remove the extra line in .conf file. I did not have log-queries=extra


How to do this on synology?


It should be the same…none of the devs have a Synology to test on however.


cd /etc/.pihole gives the error “no such file or directory”
so I believe the installation folder is different on synology… hence it doesn’t work


It shouldn’t be. Try pihole -r