Updating

Updating a regular installation

Updating is as simple as running the following command:

pihole -up

Always Read The Release Notes!

Ensure you read the release notes for all Pi-hole components. This will help you avoid common problems due to known issues with upgrading or newly required arguments. The release notes can be found in the respective repository for Core, FTL and Web. This is especially recommended for major updates like v5 -> v6. Some updates are accompanied by a post on the Pi-hole Blog mentioning notable changes.

SELinux

If SELinux is detected in Enforcing mode, pihole -up will exit rather than continue, since Pi-hole does not provide an official SELinux policy and enforcing mode may cause issues during or after the update.

Info

If you have already configured a custom SELinux policy that allows Pi-hole to function correctly, you can skip this check by setting the PIHOLE_SELINUX environment variable before running the update:

export PIHOLE_SELINUX=true
pihole -up

Setting this variable acknowledges that there may be issues with Pi-hole during or after the update while SELinux is enforcing.

Updating Docker

Please refer to the Guide in the Docker Docs

Release Notes for Docker specific changes can be found on GitHub