Pi-hole

⚠️ If you have set up your router to use Pi-hole as its only DNS server, umbrelOS may be unable to resolve domain names during the update, preventing it from downloading the update files. To avoid issues, temporarily set a backup DNS server (e.g., 1.1.1.1) on your router before updating— or configure a permanent fallback DNS to prevent future issues.

This release includes several improvements and bug fixes:

• Removed hard-coded log file paths for better container compatibility
• Improved startup process to ensure log files are created if missing
• Enhanced memory handling and performance optimizations
• Added automatic TLS/SSL certificate renewal support
• Improved DNS cache performance and query handling
• Enhanced web interface functionality with better tooltips and visualizations
• Added support for Alpine Linux
• Fixed various issues with database handling and query logging
• Improved network interface detection and configuration

Full release notes can be found at https://github.com/pi-hole/docker-pi-hole/releases/tag/2025.10.3

⚠️ If you have set up your router to use Pi-hole as its only DNS server, umbrelOS may be unable to resolve domain names during the update, preventing it from downloading the update files. To avoid issues, temporarily set a backup DNS server (e.g., 1.1.1.1) on your router before updating— or configure a permanent fallback DNS to prevent future issues.

This release includes several improvements and bug fixes:

• Improved startup process to clean orphaned files
• Enhanced web interface functionality
• Improved API command functionality
• Fixed issues with component version labeling
• Enhanced DNS cache performance

Full release notes can be found at https://github.com/pi-hole/docker-pi-hole/releases/tag/2025.08.0

⚠️ If you have set up your router to use Pi-hole as its only DNS server, umbrelOS may be unable to resolve domain names during the update, preventing it from downloading the update files. To avoid issues, temporarily set a backup DNS server (e.g., 1.1.1.1) on your router before updating— or configure a permanent fallback DNS to prevent future issues.

This release includes several improvements and bug fixes:

• Fixed an issue where the web interface couldn't run gravity
• Improved the pihole API command functionality
• Enhanced DNS cache performance with better CNAME handling
• Improved session cookie handling for better web interface access
• Fixed logging issues where types were missing from logs
• Resolved crashes in DNS filtering functionality

Full release notes can be found at https://github.com/pi-hole/docker-pi-hole/releases/tag/2025.07.1

⚠️ If you have set up your router to use Pi-hole as its only DNS server, umbrelOS may be unable to resolve domain names during the update, preventing it from downloading the update files. To avoid issues, temporarily set a backup DNS server (e.g., 1.1.1.1) on your router before updating— or configure a permanent fallback DNS to prevent future issues.

This release includes important bug fixes and improvements:

• Fixed logging issues where types were missing from logs
• Fixed crashes in DNS filtering functionality
• Improved session cookie handling for better web interface access
• Enhanced DNS cache performance with better CNAME handling
• Updated embedded components for better stability

Full release notes can be found at https://github.com/pi-hole/docker-pi-hole/releases/tag/2025.06.2

⚠️ If you have set up your router to use Pi-hole as its only DNS server, umbrelOS may be unable to resolve domain names during the update, preventing it from downloading the update files. To avoid issues, temporarily set a backup DNS server (e.g., 1.1.1.1) on your router before updating— or configure a permanent fallback DNS to prevent future issues.

This release includes improvements and bug fixes:

• Fixed majority of crashing issues seen in previous versions
• Improved stability and performance
• Enhanced DNS and query handling
• Updated embedded components for better functionality

Full release notes can be found at https://github.com/pi-hole/docker-pi-hole/releases/tag/2025.06.0

⚠️ If you have set up your router to use Pi-hole as its only DNS server, umbrelOS may be unable to resolve domain names during the update, preventing it from downloading the update files. To avoid issues, temporarily set a backup DNS server (e.g., 1.1.1.1) on your router before updating— or configure a permanent fallback DNS to prevent future issues.

This release includes minor improvements and bug fixes:

• Improved handling of web interface version
• Enhanced tips section for better clarity on webserver port conflict handling

Key changes in FTL, Web, and Core components include:

• Various UI improvements and bug fixes
• Enhanced API functionality and security
• Improved DNS and query handling
• Updated embedded components (dnsmasq, SQLite)
• Better support for different network configurations

Full release notes can be found at https://github.com/pi-hole/docker-pi-hole/releases/tag/2025.05.1

⚠️ If you have set up your router to use Pi-hole as its only DNS server, umbrelOS may be unable to resolve domain names during the update, preventing it from downloading the update files. To avoid issues, temporarily set a backup DNS server (e.g., 1.1.1.1) on your router before updating— or configure a permanent fallback DNS to prevent future issues.

This release includes a bug fix:

• Fixed Sunday cronjob issue

Full release notes can be found at https://github.com/pi-hole/docker-pi-hole/releases/tag/2025.04.0

⚠️ If you have set up your router to use Pi-hole as its only DNS server, umbrelOS may be unable to resolve domain names during the update, preventing it from downloading the update files. To avoid issues, temporarily set a backup DNS server (e.g., 1.1.1.1) on your router before updating— or configure a permanent fallback DNS to prevent future issues.

This release includes several improvements and bug fixes:

• Improved compatibility with older versions of Docker
• Added bash-completion package
• Updated gravity update schedule
• Enhanced DNS and NTP functionality
• Ensured pi.hole domain remains local and improved API and system info reporting
• Updated security and performance in API, web, and core components
• Enhanced UI with better HTTPS detection, query logging, and layout fixes
• Added support for 2FA handling and better logging in the core system
• Various bug fixes, optimizations, and UI improvements

Full release notes can be found at https://github.com/pi-hole/docker-pi-hole/releases/tag/2025.03.1

⚠️ If you have set up your router to use Pi-hole as its only DNS server, umbrelOS may be unable to resolve domain names during the update, preventing it from downloading the update files. To avoid issues, temporarily set a backup DNS server (e.g., 1.1.1.1) on your router before updating— or configure a permanent fallback DNS to prevent future issues.

This release includes several improvements and bug fixes:

• Improved DNS port configuration for docker health checks
• Added NTP port to docker compose example
• Updated embedded CivetWeb
• Improved IPv6 client name resolution
• Enhanced settings and query log functionality in the web interface
• Fixed multiple domain insertion as wildcard
• Improved memory unit selection for devices with less than 1 GB of RAM

Full release notes can be found at https://github.com/pi-hole/docker-pi-hole/releases/tag/2025.03.0

⚠️ If you have set up your router to use Pi-hole as its only DNS server, umbrelOS may be unable to resolve domain names during the update, preventing it from downloading the update files. To avoid issues, temporarily set a backup DNS server (e.g., 1.1.1.1) on your router before updating— or configure a permanent fallback DNS to prevent future issues.

This is a small fix that allows umbrelOS users to access the Pi-hole web interface via an IPv6 address.

Previous 2025.02.6 release notes:

This release comes with Pi-hole version 6 and adds a lot of new features.

Highlights:

• Redesigned User Interface
• Embedded Web Server and REST API
• Advanced Filtering and Allowlists
• Consolidated Configuration Files
• HTTPS Support
• Alpine based Docker image

Full release notes can be found at https://pi-hole.net/blog/2025/02/18/introducing-pi-hole-v6/

This release comes with Pi-hole version 6 and adds a lot of new features.

Highlights:

• Redesigned User Interface
• Embedded Web Server and REST API
• Advanced Filtering and Allowlists
• Consolidated Configuration Files
• HTTPS Support
• Alpine based Docker image

Full release notes can be found at https://pi-hole.net/blog/2025/02/18/introducing-pi-hole-v6/

🚨 This release fixes a vulnerability that was recently discovered in Pi-hole's gravity script that could allow an authenticated user to read system files through the web interface. Please update immediately.

More information can be found at https://github.com/pi-hole/pi-hole/security/advisories/GHSA-95g6-7q26-mp9x

This is a minor bug-fix release, and includes FTL v5.24, Web 5.12, and Core v5.17.3.

Full release notes can be found here: https://pi-hole.net/blog/2024/01/06/pi-hole-ftl-v5-24-and-core-v5-17-3-released/

This is a minor bug-fix release, and includes FTL v5.23, Web v5.20.2, and Core v5.17.2.

Full release notes can be found here: https://pi-hole.net/blog/2023/05/28/pi-hole-ftl-v5-23-web-v5-20-and-core-v5-17-released

Pi-hole on Umbrel now operates in host network mode, meaning that you can now easily configure Pi-hole as a DHCP server!

This version includes FTL v5.23, Web v5.20, and Core v5.17. Full release notes can be found here: https://pi-hole.net/blog/2023/05/28/pi-hole-ftl-v5-23-web-v5-20-and-core-v5-17-released

Updates Pi-hole components to FTL v5.22, Web v5.19, and Core v5.16.1

Full release notes can be found here: https://pi-hole.net/blog/2023/03/22/pi-hole-ftl-v5-22-web-v5-19-and-core-v5-16-1-released

By popular request of the Umbrel Community, this update adds the ability to use Pi-hole as your DHCP server! See Pi-hole documentation here for setting up DHCP with bridge networking: https://docs.pi-hole.net/docker/dhcp/

This update does not include any changes the versions of the Pi-hole components: Core v5.15.5, FTL v5.21, and AdminLTE v5.18.4

Starting with version 2023.02.02, the versioning of the Pi-hole app has been updated to reference the docker-pi-hole version (https://github.com/pi-hole/docker-pi-hole). This release includes specific versions of the Pi-hole components: Core v5.15.5, FTL v5.21, and AdminLTE v5.18.4

Version 2023.02.02 Changelog:

• Replace deprecated variables with the correct ones
• Remove default lightttd from the image 4961bf4

Full changelogs are available here: https://github.com/pi-hole/docker-pi-hole/releases

• FTL v5.21
• Core v5.14.4
• db_queries.php: use the same color scheme from Dashboard by @rdwebdesign in pi-hole/AdminLTE#2517
• Fix multiple restarts while importing with Teleporter by @yubiuser in pi-hole/AdminLTE#2519
• Use the setupVars.conf option TEMPERATUREUNIT, plus slight rearrangement of settings page by @rdwebdesign in pi-hole/AdminLTE#2516

Full changelog available here: https://github.com/pi-hole/AdminLTE/compare/v5.18...v5.18.4

Various internal improvements:

• FTL v5.20
• Fix doughnutTooltip if total percentage of shown slices is less than 0.1%.
• Require auth for more API endpoints.
• Increase small-box footer contrast ratio.
• A fix for the following advisory: GHSA-6qh8-6rrj-7497

• Various internal improvements
• What's Changed (FTL 5.19.2)
• Nothing Docker specific this time. This build is to include an FTL hotfix

• Various internal improvements
• Fix odd behaviour introduced into new version

• Various internal improvements

• Various internal improvements