This image is now based on the newly released Pi-hole v6.

General docker docs can be found on the docs site (https://docs.pi-hole.net/docker/) or the readme of this repo.

All the specific release notes can be found below, a summary can be found on our blog: https://pi-hole.net/blog/2025/02/18/introducing-pi-hole-v6/#page-content

What's Changed

• Remove one layer by having both git clone together by @Gontier-Julien in #1381
• Change so ADD to COPY following docker best practices by @Gontier-Julien in #1382
• Remove some unnessacery dependencies by @PromoFaux in #1366
• Re-implement SKIPGRAVITYONBOOT by @PromoFaux in #1368
• Reduce git clone size, by cloning only what is needed by @Gontier-Julien in #1391
• Add ncurses back in for the time being to fix pihole -v output. by @PromoFaux in #1392
• Allow branch names to be passed in as build args by @PromoFaux in #1384
• re-add the PIHOLE_DOCKER_TAG build arg that went missing along the way by @PromoFaux in #1395
• fix arm64 arch. use copy --chmod. reduce number of layers. by @edgd1er in #1393
• Add tzdata package so that users can define their own timezone at runtime by @PromoFaux in #1394
• Add tests back to the development-v6 container by @PromoFaux in #1396
• Allow the for changing of the UID/GID of the user/group pihole by @PromoFaux in #1403
• [dev-v6]:extracted uid/gid functions need to be rewritten to remove the return by @edgd1er in #1404
• Tell alpine specifically to install/use procps-ng by @Gontier-Julien in #1407
• Alphebetize alpine dependencies for organization. by @dschaper in #1408
• No need for uninstall.sh in the container image by @PromoFaux in #1409
• Add PADD to the image by @yubiuser in #1410
• if skipgravityonboot set, check db version. by @edgd1er in #1402
• Ensure pihole-FTL process is shut down cleanly on container exit / add tini by @PromoFaux in #1406
• Update Readme by @PromoFaux in #1429
• Make the FTL log tail optional. Pass in TAIL_FTL_LOG: 0 to silence it by @PromoFaux in #1385
• Allow end user to add additional packages to the image by @PromoFaux in #1423
• Add instructions for rebuilding the image with a custom component branch by @PromoFaux in #1444
• Update references to web repo by @PromoFaux in #1450
• Add special handling for FTL Config names that have underscores in them by @PromoFaux in #1456
• Updates to reflect FTL's native capability of reading the FTLCONF_ env vars by @PromoFaux in #1460
• Clarify delimter for array type FTLCONF_ values by @PromoFaux in #1464
• drop the /v8 from linux/arm64/v8 by @PromoFaux in #1468
• Install logrotate by @yubiuser in #1470
• Only run gravity on boot if the gravity database does not exist by @PromoFaux in #1466
• Create dir for logrotate statefile by @yubiuser in #1483
• install the logrotate file into /etc/pihole at startup in case of volume mounting by @PromoFaux in #1486
• Update alpine to 3.19 by @yubiuser in #1497
• Fix v6 build on riscv64 by @yubiuser in #1511
• Revert "Bump actions/download-artifact from 3 to 4" by @PromoFaux in #1513
• Revert "Bump actions/upload-artifact from 3 to 4" by @PromoFaux in #1514
• Artifacts v4 by @yubiuser in #1517
• Consider registry when up/downloading artifacts by @yubiuser in #1526
• Add dockerfile frontend syntax line by @yubiuser in #1529
• Tidy up a few things in the readme and code. by @PromoFaux in #1551
• Update Dockerfile by @PromoFaux in #1552
• Fix: correct dns upstreams FTLCONF_dns_upstreams variable name by @shamoon in #1557
• Remove obsolete "version" value from example docker-compose.yml files by @lemondjeff in #1569
• Install grep to avoid issues in pihole -w/b with the default busybox … by @PromoFaux in #1576
• Update DOCKER_BUILD_CMD in build.sh to include the "--load" flag by @PromoFaux in #1583
• Change default value of PIHOLE_DOCKER_TAG arg in dockerfile by @PromoFaux in #1585
• Add forgotten --load argument to the help text by @rdwebdesign in #1586
• Tweaks to readme for v6 by @PromoFaux in #1593
• Use correct delimeter in example compose file by @PromoFaux in #1594
• Add CAP_SYS_TIME in the container if available by @DL6ER in #1596
• Update github user reference by @alexis-opolka in #1598
• Add support for choosing PADD branch in build script by @PromoFaux in #1607
• Default DNS Upstream by @PromoFaux in #1608
• Add pytest-clarity to test environment to improve error log output by @yubiuser in #1609
• Add DNSMASQ_LISTENING=bind to README.md by @loeffelpan in #1615
• Bump alpine to 3.20 by @PromoFaux in #1621
• Set default tag for locally build images to pihole:local by @yubiuser in #1628
• Be more graceful when detecting a v5->v6 migration by @PromoFaux in #1629
• Development v6 -> dev by @PromoFaux in #1626
• Migrate old Pi-hole owned dnsmasq config files into /etc/pihole/migration_backup_v6 by @PromoFaux in #1641
• Confirm validity of downloaded FTL binary when building by @PromoFaux in #1643
• Update README.md by @IngmarStein in #1647
• Always terminate the container if pihole-FTL binary exits by @PromoFaux in #1649
• Remove tini from image, we don't need it as we're handling all the ex… by @PromoFaux in #1651
• Tweak README text and formatting by @rdwebdesign in #1646
• Add some hardening to the build script by @PromoFaux in #1644
• Bump base image to Alpine 3.21 by @rdwebdesign in #1671
• Pi-hole does not provide DNS-over-TLS by @yubiuser in #1674
• Bake debugging requirements into the nightly image for ease of debugging by @DL6ER in #1675
• Clarify log message for missing caps by @jnodorp in #1687
• Remove unused DHCP_ACTIVE and fix shellcheck warnings by @yubiuser in #1691
• Set default UID and GID to 1000 by @yubiuser in #1690
• Utilise FTL's native config upgrade functionality by @PromoFaux in #1683
• Development -> Master by @PromoFaux in #1692

New Contributors

• @Gontier-Julien made their first contribution in #1381
• @shamoon made their first contribution in #1557
• @alexis-opolka made their first contribution in #1598
• @loeffelpan made their first contribution in #1615
• @IngmarStein made their first contribution in #1647
• @jnodorp made their first contribution in #1687

Full Changelog: 2024.06.0...2025.02.0

Contains all commits listed in the following three releases

https://github.com/pi-hole/FTL/releases/tag/v6.0

https://github.com/pi-hole/web/releases/tag/v6.0

https://github.com/pi-hole/pi-hole/releases/tag/v6.0