From 0c35a906ce5c5a0657452c15a0a3f0e580249988 Mon Sep 17 00:00:00 2001
From: Matthew Jackson <matthew@pq.io>
Date: Tue, 19 May 2026 08:03:46 -0700
Subject: [PATCH] watchtower: include + revive stopped containers
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

basement-ui's placeholder image exits immediately, so the container sits
in a Restarting (0) loop. Watchtower's default filter only checks Up
containers, so basement was being silently skipped every cycle —
`scanned=1` in the running watchtower log was actually garage (pinned,
no update available), not basement.

INCLUDE_STOPPED=true makes watchtower check restart-looping / exited
containers too. REVIVE_STOPPED=true starts them after the update so the
new image actually runs. Once a working basement-ui image is pushed,
this combo will pick it up and the container will stop restart-looping.
---
 unraid-1/watchtower.template.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/unraid-1/watchtower.template.xml b/unraid-1/watchtower.template.xml
index 930eea1..9211fe1 100644
--- a/unraid-1/watchtower.template.xml
+++ b/unraid-1/watchtower.template.xml
@@ -51,4 +51,6 @@ Does not watch itself: a new Watchtower version requires re-Applying this templa
   <Config Name="WATCHTOWER_POLL_INTERVAL" Target="WATCHTOWER_POLL_INTERVAL" Default="300" Mode="" Description="Seconds between checks for new images. 300s (5min) is the fleet-wide default — gentle on ghcr/dockerhub rate limits, still effectively instant for new pushes." Type="Variable" Display="always" Required="true" Mask="false">300</Config>
   <Config Name="WATCHTOWER_CLEANUP" Target="WATCHTOWER_CLEANUP" Default="true" Mode="" Description="Delete the previous image after a successful update (frees disk)." Type="Variable" Display="always" Required="true" Mask="false">true</Config>
   <Config Name="WATCHTOWER_LABEL_ENABLE" Target="WATCHTOWER_LABEL_ENABLE" Default="true" Mode="" Description="Only watch containers with com.centurylinklabs.watchtower.enable=true. Leave true." Type="Variable" Display="always" Required="true" Mask="false">true</Config>
+  <Config Name="WATCHTOWER_INCLUDE_STOPPED" Target="WATCHTOWER_INCLUDE_STOPPED" Default="true" Mode="" Description="Also check exited / restart-looping containers — needed when a labelled container has a broken/placeholder image that keeps exiting (without this, watchtower silently skips them and never picks up the fixed image)." Type="Variable" Display="always" Required="true" Mask="false">true</Config>
+  <Config Name="WATCHTOWER_REVIVE_STOPPED" Target="WATCHTOWER_REVIVE_STOPPED" Default="true" Mode="" Description="After updating a stopped container's image, start the container. Pairs with INCLUDE_STOPPED — otherwise watchtower pulls the new image but leaves the container stopped." Type="Variable" Display="always" Required="true" Mask="false">true</Config>
 </Container>