Skip to content

Conversation

@chippy01
Copy link

Added instructions to exclude Pi-hole container from Watchtower's auto-update system.

Description

Modified the README file in order to add the instructions to fully exclude the Pi-hole container from Watchtower.
The instructions can be find in Watchtower's official documentation Full exclude section

Motivation and Context

This change avoids a new Pi-hole user to go back on Watchtower's documentation to find how to exclude some container from the auto-update system.
The simple pice of setting that needs to be added on the Docker-compose is now available directly in the Pi-hole README

How Has This Been Tested?

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)

Checklist:

  • My code follows the code style of this project.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.

Added instructions to exclude Pi-hole container from Watchtower's  auto-update system.

Signed-off-by: Alex Ferrarini <[email protected]>
@chippy01 chippy01 requested a review from a team as a code owner November 12, 2025 16:36
Copy link
Member

@yubiuser yubiuser left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Personally, I'd prefer to just link to the respective watchtower documentation on how to exclude a specific service from it. Our Readme is already quite long. I think linking to the right place of their documentation is already enough hand-holding.

@rdwebdesign
Copy link
Member

I agree.

A link to the Full Exclude option is enough.

@chippy01
Copy link
Author

Yeah, maybe just a link is enough, the watchtower guide for Full Exclusion is pretty straightforward, there's no need for a further explaination in the Pi-hole documentation.
As soon as i can i'll update the pull request.

Removed full explaination, reduced to a single link.

Signed-off-by: Alex Ferrarini <[email protected]>
- 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.
If you wish to exclude the Pi-hole container from Watchtower's auto-update system take a look at [Full Exclude](https://containrrr.dev/watchtower/container-selection/#full_exclude) in Watchtower's docs.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If you wish to exclude the Pi-hole container from Watchtower's auto-update system take a look at [Full Exclude](https://containrrr.dev/watchtower/container-selection/#full_exclude) in Watchtower's docs.
To exclude the Pi-hole container from Watchtower's auto-update system take a look at [Full Exclude](https://containrrr.dev/watchtower/container-selection/#full_exclude) in Watchtower's docs.

Just this tweak from me please - keeps the tone more in line with the overall message we are trying to get across.

And just to keep it tidy, please squash the commits down to one

thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants