pi-hole/pi-hole

How do I update my Pi-hole?

• How do I install Pi-hole?
• How do I test if my Pi-hole is working?
• How do I access my Pi-hole's Web interface?
• How do I use FTL's API?
• Why is FTL offline and showing "Lost Connection To API"?
• Where do I go for more answers?

See the Web changelog here

See the FTL changelog here

Tweaks

• Don't auto-whitelist blocking list domains #1973
• Always replace pihole-FTL.service on repair #1981
• Store checked out FTL branch in /etc/pihole/ftlbranch #2030

Fixes

• pihole -f: Flush database records #1929
• Always create blacklist.txt #1982

How do I update my Pi-hole?

• How do I install Pi-hole?
• How do I test if my Pi-hole is working?
• How do I access my Pi-hole's Web interface?
• How do I use FTL's API?
• Why is FTL offline and showing "Lost Connection To API"?
• Where do I go for more answers?

See the Web changelog here

See the FTL changelog here

Note: This release changes to way dnsmasq is writing its logs to its log file.

New

• Enable dnsmasq's extra logging feature #1859
• Add secondary quad9 server #1778
• Add "pihole logging off noflush" command #1922

Tweaks

• Add fallback interface in DNS settings #1897
• Force update of update checker for new installs #1878
• Remove the pihole update line from the cron file #1908
• Renamed functions in gravity.sh to make them more readable #1913
• Use more secure temp files for installation logging #1925
• Create required folders for FTL before it starts #1885

Fixes

• Use .lan as fallback TLD for DHCP generated domains #1918
• Fix epel-release install for CentOS #1901
• Fix for "Binary file matches" error in gravity.list generation #1910
• Fix typo in debugger output #1904
• Fix type in installer output #1936
• Fix "Bad file descriptor" errors in Chronometer #1880
• Fix FTL's version saving incorrectly, causing it to always show up as vDev on the web interface #1866
• Fix update/repair sometimes failing when no web interface has been installed #1873

How do I update my Pi-hole?

• How do I install Pi-hole?
• How do I test if my Pi-hole is working?
• How do I access my Pi-hole's Web interface?
• How do I use FTL's API?
• Why is FTL offline and showing "Lost Connection To API"?
• Where do I go for more answers?

See the Web changelog here

See the FTL changelog here

This is a bug fix release for some minor bugs that have been reported in Pi-hole v3.2

New

• Add support for local blocking lists #1779

Tweaks

• Randomize update checker time #1857
• Only check for updates against the GitHub API once a day #1825
• Update DNSSEC trust anchor #1854
• Change package install notification from CROSS to INFO #1836
• Change output of gravity lines containing numbers. #1850
• Improve debug script compatibility with service and systemctl #1818

Fixes

• Improve gravity DNS check compatibility #1812
• Check NetworkManager status prior to using the cli (#1653) #1811
• Revert gravity parsing method to that of 3.1.4. This avoids false entries in gravity.list #1840
• Fix sending headers after html #1829
• Remove quotes from the uniqDomains array to actually whitelist the source domains #1849
• Add new DNSSEC trust anchor record for authentication rolllover. #1861
• Fix pihole.log permissions if mounted on tmpfs or accidentally removed #1817

How do I update my Pi-hole?

• How do I install Pi-hole?
• How do I test if my Pi-hole is working?
• How do I access my Pi-hole's Web interface?
• How do I use FTL's API?
• Why is FTL offline and showing "Lost Connection To API"?
• Where do I go for more answers?

See the Web changelog here

See the FTL changelog here

New

• Audit log (implemented feature request) #1399
• Add pihole checkout ftl #1567
• Add web frontend shutdown command #1572
• Allow for Custom block page #1688
• Add pihole -a email functionality for Block Page contact email #1691
• add SELinux checks to debug script #1735
• Use cron based update checker to speed up web interface #1752
• Support local blocklists (implemented feature request) #1779

Tweaks

• Randomize gravity update time (implemented feature request) #1747
• Send SIGHUP to pihole-FTL when restarting/reloading dnsmasq #1751
• Add nuclear option to list.sh #1728
• Add VPN host names to local.list #1682 #1718
• Gravity: Add ignore-case switch to sort (domains) #1687
• Colourised output text #1471
• Make Chronometer usable on smaller screens #1518
• Revamp of debug script to better allow users to self-diagnose their installs #1565, #1585
• Install Script: Add comments for nearly every line of code #1586
• User-friendly pihole -q output #1483
• Avoid reactivating a deactivated lighttpd service #1485
• Only download FTL if a newer version than currently installed is detected (or if no version is detected) #1600
• Block Page 2.0 #1416
• Prevent Let's Encrypt HTTPS from causing Block Page issues #1420
• Decrease local-ttl to 2 #1701
• Cleanup uninstall script #1663
• Clean up and optimise Gravity #1631
• Start and enable FTL prior to running Gravity #1700

Fixes

• Allow passwords with spaces #1780
• Minor gramatical and formatting fixes #1757
• Fix IPv6 wildcard blocking (if CIDR is present) #1556
• Fix IPv6 gravity generation (if CIDR is present) #1564
• Fix install script using IPv6 CIDR notation #1570
• Use the correct hostname for Pi-hole (regression) #1560
• Accept underscores when validating domain names #1571
• Show text typed when pressing Ctrl+C after using pihole -a -p #1587
• Prevent Web Admin from printing restartdns colour codes #1575
• Provide correct FTL stats #1619
• Fix pihole -q if adlists URLs have been removed #1618
• Always process DNS and DHCP settings in installer #1630
• Stop an extra h being added to leasetime of DHCP server. #1646
• Fix URL extension parsing in certain cases on the block page #1602
• Replace superseded netstat command #1676
• Add php5-sqlite to dependencies #1581
• Slow query fix & queryFunc optimisation #1694
• Exclude files from Web Admin that should not be accessible #1704
• Correctly highlight Pi-hole's IPv4/6 addresses when running pihole tail #1707

How do I update my Pi-hole?

New

• Fixes a bug where CIDR was stored alongside IPv6 address. #1617

See the Web interface changelog here.

New

• Chronometer 2 #1474
• Tricorder debug logs are now uploaded using SSL when openssl is available #1464
• Tricorder has a 10 second opt-out window if openssl isn't available when uploading #1469
• IPv6: Use ULA addresses in favor of GUA addresses if available #1508
• Add weekly logrotation of FTL's log #1509
• Separate blacklist into blacklist.list from gravity.list #1534

Tweaks

• Install loopback firewall rules for FTL #1419
• Default dhcpcd.conf nameservers to 127.0.0.1 #1436
• Version now displays FTL data. New flags and re-written script. #1447 #1459
• Improve busybox portablity and support #1465
• Improve formatting of help docs #1468
• Fixed handling of pihole -wild help text #1317
• Repair/Reconfigure will reset any changes made to /etc/.pihole and /var/www/html/admin #1481 #1491
• Stash changes when using checkout #1384
• Update adlist query to search whitelist #1456

Fixes

• Apt failure message doesn't show internal function name to users. #1446
• Fix whitelisting via block page if not on the root page #1452
• Debug log now shows status of Gateway checks #1455
• Only logrotate once at midnight #1476
• Disable wildcard-list when disabling Pi-hole #1495
• FTL would update twice if both it and core had an update #1517
• Correct permissions on /etc/pihole #1530
• Delete temporary FTL install files after install #1532

See the Web interface changelog here.

New

• Add localise-queries flag to dnsmasq's config #1408

Tweaks

• Update default User Agent to modern browser. #1406
• Add option to enter new password as command arg #1421
• Include pihole-FTL.log in debug report #1418

Fixes

• Double hash the password directly in the install script #1423
• Add dialog to dependencies #1280

See the Web interface changelog here.

User-voted featured requests implemented in this release

• ?

New

• FTL integration #1244

Tweaks

• Add check on file_parse to not include WEBPASSWORD= in the debug log #1331 (Implemented feature request)
• Tweak DNS debugging #1294
• Skip inclusion of hashed pass in debug log #1331
• Tweak how we find valid link interfaces #1334
• Debugger improvements and prep for future features #1335
• Match the Pi-hole brand #1358
• Only show the block page when blocking an ad domain (404 handler) #1361
• Use correct agent when downloading adaway.org list #1366
• Mask password when changing/setting it #1355
• Only use adlist.list moving forward #1365
• Rotate the log twice so FTL doesn't see it #1391
• Redirect bare pi.hole requests to admin page #1297

Fixes

• Allow installs without the web interface to update #1348
• Some special browsers might not display the blocking page #1354
• Remove temp files created by gravity #1394

See the Web interface changelog here.

New

• Pi-hole checkout feature #1310

Tweaks

• Account for hash in versioning #1293
• Require 4 approvals instead of five for merging into master #1295
• Debug version detection improvements #1296

Fixes

• Bugfix for when deleting host-record #1300
• Remove wildcard entry when adding the very same domain either the white- or blacklist #1301
• Check for existence of wildcard blocking list (query adlists) #1302
• Don't try to obtain version of web interface if it is not installed #1307