Skip to content

Releases: pi-hole/docker-pi-hole

2022.02.1

13 Feb 01:11
@PromoFaux PromoFaux
2022.02.1
1b35e7f
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
2022.02.1

https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=923479

What's Changed

  • Revert base image to buster, we can try bullseye again later, there are a couple of teething issues by @PromoFaux in #1003

Full Changelog: 2022.02...2022.02.1

Contributors

PromoFaux
Assets 2

2022.02

12 Feb 20:25
@PromoFaux PromoFaux
2022.02
6b5f746
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
2022.02

What's Changed (Docker Specific)

  • Prevent logspam when restarting FTL (Error from kill command) by @PromoFaux in #973
  • Update list of available web themes by @AlexanderLieret in #970
  • Switch base image from Buster to Bullseye by @PromoFaux in #976
  • Don't attempt to chmod pihole-FTL.db if it does not exist by @PromoFaux in #978
  • If PIHOLE_DNS_ env var is employed, use that as source of truth by @PromoFaux in #981
  • Use consistent method to kill process in s6 finish script by @PeterDaveHello in #987
  • [Experimental] Add ability to change UID / GID for www-data and pihole user. by @edgd1er in #982
  • Touch/chown lighttpd access/error logs on service start by @PromoFaux in #991
  • [Experimental] Add ability to Redirect lighttpd logs to stdout by @edgd1er in #990
  • make prerequisites more precise by @sebastiansterk in #994
  • Adding TZ var to PHP environment by @rdwebdesign in #996
  • Adding text message asking to select "dev" branch on new PR by @rdwebdesign in #997

New Contributors

Full Changelog: 2022.01.1...2022.02

This release also contains updates for the 3 main components (FTL v5.14, Web v5.11, and Core v5.9), Changelogs below:

What's Changed (FTL)

New Contributors

Full Changelog: pi-hole/FTL@v5.13...v5.14

What's Changed (Web)

New Contributors

Full Changelog: pi-hole/web@v5.10.1...v5.11

What's Changed (Core)

New Contributors

Full Changelog: pi-hole/pi-hole@v5.8.1...v5.9

Contributors

rdwebdesign, chrismiceli, and 12 other contributors
Assets 2

2022.01.1

05 Jan 23:02
@PromoFaux PromoFaux
2022.01.1
4cc3587
This commit was signed with the committer’s verified signature.
PromoFaux Adam Warner
GPG key ID: 872950F3ECF2B173
Learn about vigilant mode.
Compare
Choose a tag to compare
2022.01.1

Docker Specific:

  • Increase verbosity of error message when capabilities cannot be set, add note to readme about default DNSMASQ_USER. by @PromoFaux in #964
  • Remove shim to add docker tag to debug script now that it is in the core repo by @PromoFaux in #965

Full Changelog: 2022.01...2022.01.1

Notes - this release should no longer require the use of CAP_SYS_PTRACE (if you used it as a workaround in the last release) - so that capability can be safely removed.

In 2022.01 and later, the default DNSMASQ_USER has been changed to pihole, however this may cause issues on some systems. See Issue #963 for more information. If the container wont start due to issues setting capabilities, set DNSMASQ_USER to root in your environment.

This release also includes updates to the core Pi-hole components, changelog below.

FTL 5.13:

Full Changelog: pi-hole/FTL@v5.12.1...v5.13

Core 5.8

New Contributors

Full Changelog: pi-hole/pi-hole@v5.7...v5.8

Web 5.10

New Contributors

Full Changelog: pi-hole/web@v5.9...v5.10

Contributors

rdwebdesign, PromoFaux, and 7 other contributors
Assets 2

2022.01

03 Jan 20:14
@PromoFaux PromoFaux
2022.01
2a7ea09
This commit was signed with the committer’s verified signature.
PromoFaux Adam Warner
GPG key ID: 872950F3ECF2B173
Learn about vigilant mode.
Compare
Choose a tag to compare
2022.01

Docker Specific Changes

  • Fix duplicate php env config values after upgrades and config changes by @mfschumann in #957
  • Switch default DNSMASQ_USER to pihole from root, and fix permissions on pihole-FTL.db to belong to pihole:pihole 0eb1a60
  • bump s6 to latest 44bdfc1
  • use kill -15 (TERM) instead of 9 to exit FTL a bit more gracefully and save queries to the database a5eda68

NOTE: Synology users may need to set DNSMASQ_USER to root in their environment #963

No changes to the core Pi-hole components

New Contributors

Full Changelog: 2021.12.1...2022.01

Contributors

mfschumann
Assets 2

2021.12.1

25 Dec 12:56
@PromoFaux PromoFaux
2021.12.1
b0a5a0f
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
2021.12.1

Same as 2021.12, but incorporates a hotfix release of FTL:

Contributors

DL6ER
Assets 2

2021.12

22 Dec 20:43
@PromoFaux PromoFaux
2021.12
b0a5a0f
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
2021.12

Docker Specific Changes

What's Changed

  • Update Dockerfile to use COPY instead of ADD as recommended on https:… by @TheDen in #946
  • Trailing slashes on volumes fail on newer versions of docker-compose by @Paraphraser in #949

New Contributors

Full Changelog: 2021.11...2021.12

Pi-hole FTL Changes

What's Changed

Full Changelog: pi-hole/FTL@v5.11...v5.12

Pi-hole Core Changes

What's Changed

New Contributors

Full Changelog: pi-hole/pi-hole@v5.6...v5.7

Pi-hole Web Changes

What's Changed

New Contributors

Full Changelog: pi-hole/web@v5.8...v5.9

Contributors

aviddiviner, TheDen, and 16 other contributors
Assets 2

Docker Pi-hole 2021.11

26 Nov 23:32
@PromoFaux PromoFaux
2021.11
4aaf099
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
Docker Pi-hole 2021.11

Docker specific changes

  • Publish images to GHCR alongside DockerHub by @ferferga in #940
  • Fixed link to reverse proxy by @moritzbeck01 in #939
  • Customize pihole-FTL.conf with FTLCONF_ prefixed environment variables. by @AlexandreRatte in #944

Pi-hole FTL Changes

  • None

Pi-hole Core Changes

  • None

Pi-hole Web Changes

  • None

New Contributors

  • @ferferga made their first contribution in #940
  • @moritzbeck01 made their first contribution in #939

Full Changelog: 2021.10.1...2021.11

Contributors

ferferga, AlexandreRatte, and moritzbeck13
Assets 2

Docker Pi-hole 2021.10.1

23 Oct 19:44
@PromoFaux PromoFaux
2021.10.1
c0d05f2
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
Docker Pi-hole 2021.10.1

Breaking Changes:

  • Should be no showstoppers, but keep in mind internal components have been version-bumped (Pi-hole FTL v5.11, Web v5.8 and Core v5.6) Please ensure you have read the release notes for those before updating!

Docker Specific Changes:

  • Use the namespace from secrets so others can build too. #928 by @dschaper
  • Export PIHOLE_VERSION as PIHOLE_DOCKER_TAG to PHP environment #930 by @PromoFaux

Full Changelog: pi-hole/FTL@2021.10...2021.11

Pi-hole FTL changes:

  • Prevent race collisions when parsing FTL config file #1222
  • Fix incorrect response times for complex CNAMEs #1213
  • Improve CI tests #1212
  • Ensure compatibility with alpine 3.13+ #1210
  • Support dynamic linking as fallback #1204 (thanks @pemensik)
  • Add PIHOLE_PTR=HOSTNAMEFQDN option #1202
  • Tweak rate-limiting #1199
  • Improve interface detection #1198
  • Fix rare crashes when rate-limiting happens before queries are blocked #1197
  • Fix network byte order confusion in local lookups #1196
  • Fix deep CNAME inspection #1192

All @DL6ER unless otherwise noted.

Full Changelog: pi-hole/FTL@v5.10.2...v5.11

Pi-hole Core Changes:

  • List fix: no reload #3981 by @andras-tim
  • Consequently use defined file path variables #4105 by @MichaIng
  • Remove obsolete DEB package name checks #4106 by @MichaIng
  • add --no-rebase to the git pull command(s) to squelch hint message in newer versions of git (#4226) by @PromoFaux)
  • Add ca-certificates to INSTALLER_DEPS #4343 by @yubiuser
  • Remove netcat from dependencies (#4346) by @yubiuser
  • Do not export DNS_FQDN_REQUIRED and DNS_BOGUS_PRIV unconditionally #4354 by @yubiuser
  • Do not account for refactor anymore (#4355) by @yubiuser
  • Do not let the user select if they want to blocking via IPv4 and/or IPv6 #4357 by @yubiuser
  • Install script comment tweaks (#4361) by @PromoFaux
  • Remove unused wildcard_regex_converter.sh (#4369) by @yubiuser
  • Remove .idea/ #4373 by @friederbluemle
  • Set file permission for querie database in pihole-FTL.service #4328 by @yubiuser
  • Tweak final whiptail dialog #4321 by @PromoFaux
  • Companion to pi-hole/web#1231 #4375 by @PromoFaux
  • Simplify vw_adlist #4379 by @yubiuser
  • Make debug log file size human readable #4350 by @yubiuser
  • Update upstream DNS server capability descriptions #4363 by @xanoni
  • Include df -h in debug log #4380 (by @yubiuser)
  • Fix PHP8.0 detection #4383 by @MichaIng
  • Tweak local DNS record and CNAME #4384 by @yubiuser
  • update tests: remove fedora 32, add fedora 34 #4403 by @bcambl

Full Changelog: pi-hole/pi-hole@v5.5...v5.6

Pi-hole Web changes:

  • Dashboard icons - send to back and fixing position when scaled up #1915 by @rdwebdesign
  • Unescape German umlauts #1914 by @yubiuser
  • Add note to query log that pi.hole queries are not logged #1913 by @yubiuser
  • Do not default true for unset variables DNS_FQDN_REQUIRED and DNS_BOGUS_PRIV #1909 by @yubiuser
  • Background colors on Query log + striped table #1916 by @rdwebdesign
  • fix: row background colors in query log #1906 by @lionralfs
  • Make entire Forgot Password box header clickable #1917 by @davidjb
  • #1777 "Remember me for 7 days" doesn't work if you log in from Recent Queries #1870 by @chrismiceli
  • Handle empty "" domain in query top list correctly #1790 by @yubiuser
  • Modal-Dialog for Teleporter-import #1231 by @Th3M3
  • Suppress empty lines during teleporter import #1921 by @yubiuser
  • Do not try to resolve hostname of clients in long-term data #1931 by @yubiuser
  • Add delete button to the network table to allow deleting individual entries #1924 by @yubiuser
  • Do not restart for every item during Teleporter import of Local DNS record or CNAME #1925 by @yubiuser
  • Display Docker Tag in footer if the PIHOLE_DOCKER_TAG environment variable is detected #1933 by @PromoFaux
  • Set font's color in teleporter iframe (fix for #1923) #1934 by @PromoFaux
  • Prevent possible XSS attack vector on add_client GHSA-mhr8-7rvg-8r43 thanks to @stypr and @rpunnett for reporting

Full Changelog: pi-hole/web@v5.7...v5.8

Contributors

andras-tim, friederbluemle, and 15 other contributors
Assets 2

2021.10

30 Sep 21:12
@PromoFaux PromoFaux
2021.10
d036e0d
This commit was signed with the committer’s verified signature.
PromoFaux Adam Warner
GPG key ID: 872950F3ECF2B173
Learn about vigilant mode.
Compare
Choose a tag to compare
2021.10

It must be October somewhere in the world, right?

Breaking Changes:

  • Should be no showstoppers, but keep in mind internal components have been version-bumped (Pi-hole FTL v5.10.2, Web v5.7 and Core v5.5) Please ensure you have read the release notes for those before updating!

Docker Specific Changes:

  • Untangle FTL Version from image building #921
  • Change install.sh to always install latest released Pi-hole unless otherwise indicated by env vars ca69e29
  • Reduce test CI step to only running tests on amd64/buster, and switch to using native docker/build-push-action@v2 / buildx actions to build and deploy the multiarch image 7624fc3 (see #735)
  • [Experimental - Feedback needed] Added linux/arm/v6 to build bc545b6
  • [Experimental - Feedback needed] Added linux/ppc64le to build c371768
  • #895 should now be fixed, as we are now using buildx to make the multiarch images

Pi-hole FTL changes:

  • Handle TTL for blocked queries separately #1173
  • Improvements based on static-analysis of source code #1172
  • Add special handling of iCloud Private Relay domains #1171
  • Fix virtual interface address determination #1170
  • Add handling for pi.hole.<local_domain> and <hostname>.<local_domain> #1169
  • Simple maintenance improvements #1167 (thanks @a1346054)
  • Add PIHOLE_PTR=HOSTNAME option #1164
  • Tweak special domain handling #1163
  • Change FTL database permission to 664 #1162 (thanks @yubiuser)
  • Add further cache metrics #1152
  • Update embedded dnsmasq to v2.87test3

Pi-hole Core Changes:

  • Remove local-ttl from set of default dnsmasq options #4339 @DL6ER
  • Fix for gravity syntax error (see #4322) #4324 @jpgpi250
  • Export DNS_FQDN_REQUIRED and DNS_BOGUS_PRIV to setupVars.conf during installation #4327 @yubiuser
  • Perform a check of required packages before updating Pi-hole #4326 @yubiuser
  • Select proper PHP version on RPM based OS after INSTALLER_DEPS have been installed #4325 @yubiuser
  • Add ca-certificates to INSTALLER_DEPS #4343 @yubiuser

Pi-hole Web changes:

  • Remove adlists tab from settings page #1845
  • footer.php: move FTL before Web Interface #1854 @XhmikosR
  • Add forgotten target_blank #1884
  • Add delete button to message table #1886
  • Clarify that never forward non-FQDN only applies to A and AAAA queries #1887
  • Simple maintenance improvements #1892 @a1346054
  • Lift prefix limitaion for --rev-server #1897

Contributors

XhmikosR, DL6ER, and 3 other contributors
Assets 2

2021.09

11 Sep 22:31
@PromoFaux PromoFaux
2021.09
1a7bfdc
This commit was signed with the committer’s verified signature.
PromoFaux Adam Warner
GPG key ID: 872950F3ECF2B173
Learn about vigilant mode.
Compare
Choose a tag to compare
2021.09

Previously, we have picked a version number of one of the internal components (most recently, FTL) and applied that to the docker container's tag. However, this sometimes causes confusion between users, but also developers (when we are not sure what to tag a docker release if FTL's version number has not changed)

Going forward, we will use a year.month[.revision] to tag docker releases with. To tag a new image, it is as simple as looking at the calendar to decide what the tag name should be. We will always try to leave any major changes until a new month rolls over. e.g if Pi-hole v6 were to be released in 2 weeks time, it would not be in the docker image until 2021.10 (that said, we can also tag pre-release versions for those that are itching to get onto the bleeding edge. This also gives us chance to make sure that none of the core Pi-hole changes break how the container operates.

There will always be a :nightly tag, which is built every night based on the dev branch of this repo, and the development/devel branches of the three components, for those who really want to live on the edge - but we don't recommend running this in production.

We have also noticed that a lot of people use Watchtower or Portainer to keep their Pi-hole containers up to date. For the same reason we don't provide an auto-update feature on a bare metal install, you should not have a system automatically update your Pi-hole container. Especially unattended. As much as we try to ensure nothing will go wrong, sometimes things do go wrong - and you need to set aside time to manually pull and update to the version of the container you wish to run. The upgrade process should be along the lines of:

  • Important: Read the release notes. Sometimes you will need to make changes other than just updating the image
  • Pull the new image
  • Stop and remove the running Pi-hole container
    • If you care about your data (logs/customizations), make sure you have it volume-mapped or it will be deleted in this step.
  • Recreate the container using the new image

Pi-hole is an integral part of your network, don't let it fall over because of an unattended update in the middle of the night.

Breaking Changes:

  • None

Docker Specific Changes:

  • 3865e77 - Introduce internal PIHOLE_TAG variable so that we can see what tag the container is...
  • 388f0f0 - Disable some more pihole functions when run from within docker, Inject a message into the debug output that lets us know it's been run in a docker container
  • 88518b0 & 56f4933 - Inject the container tag into the web interface footer
  • Set FTL REPLY addresses instead of setupVars.conf. #902
  • Improve Docker Healthcheck: Shorten dig output #905

Pi-hole Core Changes:

Pi-hole Web changes:

Pi-hole FTL changes:

  • Customizable locking while database is busy pi-hole/FTL#1156
  • Regex extension: Specify reply type pi-hole/FTL#1159
  • Update embedded dnsmasq to version 2.86
  • Improve locking during heavy TCP forking pi-hole/FTL#1134
  • Log when listening on the wildcard address pi-hole/FTL#1135
  • Improve warning messages for defect hwclocks pi-hole/FTL#1136
  • Fix crash when bind-address is used pi-hole/FTL#1132
  • Plus a lot more smaller changes that came up during our beta testing. See the Pi-hole release blog post for all the details.
Assets 2