Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
VGSources
Blog

How to Auto-Update Docker Container Images With Watchtower

A practical Watchtower guide covering Docker API access, interval versus six-field cron scheduling, enable-label allow-lists, monitor-only checks, restart behavior, cleanup trade-offs, and recovery planning.
Length9 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Run Watchtower as a Docker service next to the containers it manages, give it access to the Docker API, and configure exactly one update trigger: a polling interval or a six-field cron schedule. For production, combine an enable-label allow-list with monitor-only mode while you verify behavior, then enable restarts for services with a documented rollback plan.

The safest rollout is deliberate: scope the containers, choose a maintenance window, observe one or more checks without changing anything, and enable image cleanup only after deciding how you will recover the previous version.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What Watchtower does when an image changes

Watchtower periodically asks the Docker daemon which images are available for the containers it is watching. When it detects a newer image, it carries out its documented replacement and restart behavior for eligible containers. It is an image-and-container automation service; it does not replace application-level deployment checks such as database migrations, configuration validation, or health testing.

Watchtower must be able to communicate with the Docker daemon used by the target containers. In a conventional single-host deployment, that means running Watchtower on the same Docker host and exposing the host’s Docker API through the deployment’s normal mechanism, commonly a mounted Unix socket. Follow your host’s security policy when granting that access because it gives the service control over Docker resources.

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.

Every container is not necessarily a candidate. Watchtower can inspect a broad set of containers, or it can operate as an explicit allow-list. It can also check for updates and send notifications without changing a container, which is useful when a human must approve an upgrade.

Decide what should be updated before you deploy

Inventory the containers and their rollback needs

List the containers on the Docker host, the image each one uses, its data volumes, and the way you would return to the previous image. Separate stateless services from databases, queues, and other stateful workloads. A container that can be recreated quickly is a different operational decision from one whose upgrade could require a coordinated data or schema change.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Identify the services that may be restarted automatically.
  • Identify services that require a maintenance window or a human review.
  • Record an image tag or digest, configuration source, and data-backup procedure for each critical service.
  • Decide who will review notifications and logs after a scheduled run.

Choose an explicit targeting policy

For a small development host, watching all discovered containers may be acceptable. For production, use the enable-label allow-list. With --label-enable, or the equivalent WATCHTOWER_LABEL_ENABLE=true, Watchtower selects only containers carrying com.centurylinklabs.watchtower.enable=true. Add that label only after the service has an approved maintenance and rollback plan.

Separate observation from authorization

Monitor-only mode checks for newer images, sends notifications, and invokes configured pre- and post-update hooks, but does not perform the update. Use it for databases, stateful services, or images that require a compatibility check. It lets you confirm image discovery, timing, and notifications before allowing a restart.

Choose one way to schedule checks

Watchtower supports two mutually exclusive timing modes. Configure either a fixed polling interval or a six-field cron schedule; do not configure both.

Timing mode Flag Environment variable When it fits
Fixed interval --interval WATCHTOWER_POLL_INTERVAL Repeat a check after a consistent number of seconds.
Six-field cron --schedule WATCHTOWER_SCHEDULE Run checks in a defined maintenance window.

Use an interval for a simple cadence

The documented default poll interval is 86,400 seconds, or 24 hours. Set a different value when you want checks more or less frequently. For example, this command starts Watchtower with an hourly poll and an enable-label allow-list:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed
docker run -d --name watchtower --restart unless-stopped -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --label-enable --interval 3600

The command illustrates the timing choice: it supplies --interval 3600 and does not supply --schedule. Adapt the Docker API connection to the mechanism used by your host.

Use cron for a maintenance window

A schedule uses six cron fields. The official example 0 0 4 * * * runs daily at 04:00. The extra field compared with many traditional five-field cron examples is significant; copy the six-field form exactly.

docker run -d --name watchtower --restart unless-stopped -v /var/run/docker.sock:/var/run/docker.sock -e WATCHTOWER_SCHEDULE='0 0 4 * * *' containrrr/watchtower --label-enable

If the window must follow a particular local timezone, set TZ in the Watchtower container. Otherwise, a schedule can run at a different clock time than the one operators expect because the container and the host may use different timezone settings.

docker run -d --name watchtower --restart unless-stopped -v /var/run/docker.sock:/var/run/docker.sock -e WATCHTOWER_SCHEDULE='0 0 4 * * *' -e TZ='Europe/London' containrrr/watchtower --label-enable

Use one timing configuration in either command. Supplying both an interval and a schedule creates an ambiguous configuration and is contrary to the documented interface.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Build a safe container selection

Label only approved services

Apply the enable label to the service definitions that have passed your maintenance review:

services:
  web:
    image: nginx:latest
    labels:
      - 'com.centurylinklabs.watchtower.enable=true'
  database:
    image: postgres:latest

With label-enforcement enabled, the web service is eligible and the database service is not. The example uses familiar images only to show placement of the label; choose image tags and data-management procedures appropriate to your applications.

Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)

Keep sensitive services in monitor-only mode

You can combine the allow-list with monitor-only behavior so that only labeled containers are checked, while no container is replaced automatically:

docker run -d --name watchtower --restart unless-stopped -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --label-enable --monitor-only --interval 3600

During this phase, review Watchtower’s output and notifications for the expected image changes. A notification without a restart is the intended result in monitor-only mode, not a failure.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Use different Watchtower instances only with a clear ownership model

If one host needs separate schedules or policies, document which Watchtower instance owns each container. Overlapping instances can both discover the same service and make troubleshooting harder. A simpler arrangement is one instance with labels, one timing mode, and an explicit exception list handled outside the automatic update path.

Understand replacement, restart, and no-restart behavior

When an eligible newer image is found and monitor-only mode is not enabled, Watchtower performs its documented update and restart workflow. Expect a brief service interruption unless the application and its surrounding architecture provide redundancy. Schedule checks when that interruption is acceptable and verify the service after the run.

What --no-restart changes

The --no-restart option changes the normal restart behavior. It can be useful when a separate process controls when a service is restarted, but it also changes the point at which the new image becomes active. Test this option with the exact image and orchestration arrangement used in production rather than assuming it behaves like a routine rolling deployment.

Watchtower’s self-update exception

Watchtower can encounter a special case when it updates its own container. Current documentation warns that combining --no-restart with --cleanup during a Watchtower self-update can leave a renamed Watchtower container running without starting a new one. Review this warning before using those two options together, and keep a manual recovery procedure for restoring the Watchtower service.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

Decide whether to remove old images

--cleanup removes the old image after Watchtower restarts a container with a newer image. This limits accumulated image storage, but it also removes the immediately previous image from the local cache. Cleanup is therefore a storage policy and a rollback decision, not merely housekeeping.

Leave cleanup disabled while establishing confidence

During an initial rollout, keep the previous image available. If the new container fails a health check or exposes a compatibility problem, the old local image may be useful for a fast manual recovery. Confirm exactly which image reference and configuration produced the last known-good container.

Enable cleanup only after choosing another rollback path

Once you enable cleanup, retain a separate rollback method for important services. That may be an immutable image digest recorded in deployment configuration, a registry copy of the known-good image, or an operational backup that allows the container to be recreated. Watchtower does not turn cleanup into a version-history system; it removes the old local image after replacement.

Practical deployment patterns

Hourly allow-list updates

This pattern checks every 3,600 seconds and updates only services with the enable label:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
docker run -d --name watchtower --restart unless-stopped -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --label-enable --interval 3600

Use it for a host where an hourly maintenance cadence is acceptable. Keep databases and other sensitive containers unlabeled or run the instance in monitor-only mode until they have been reviewed.

Daily maintenance-window updates

This pattern checks once daily at 04:00 using the six-field schedule:

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.
docker run -d --name watchtower --restart unless-stopped -v /var/run/docker.sock:/var/run/docker.sock -e WATCHTOWER_SCHEDULE='0 0 4 * * *' -e TZ='UTC' containrrr/watchtower --label-enable

Change TZ to the timezone that defines your maintenance window. Do not add --interval or WATCHTOWER_POLL_INTERVAL to this deployment.

Observe first, then authorize

Start with the same target labels and schedule but add --monitor-only. After you have reviewed several checks and confirmed that notifications identify the intended services, remove monitor-only mode in a controlled change. Keep cleanup disabled until rollback is proven.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Configuration reference

Decision Configuration Operational effect
Check cadence --interval or WATCHTOWER_POLL_INTERVAL Poll at a fixed number of seconds; the documented default is 86,400 seconds.
Maintenance window --schedule or WATCHTOWER_SCHEDULE Use a six-field cron expression such as 0 0 4 * * * for daily 04:00 checks.
Timezone TZ Set the timezone used when interpreting a cron schedule.
Target scope --label-enable or WATCHTOWER_LABEL_ENABLE=true Restrict monitoring and updates to containers labeled com.centurylinklabs.watchtower.enable=true.
Action level --monitor-only Check, notify, and run hooks without performing the update.
Restart policy --no-restart Suppress the normal restart behavior; review the self-update warning when combined with cleanup.
Storage hygiene --cleanup Remove the old image after replacement and restart, reducing local image retention.

Roll out Watchtower step by step

  1. Confirm Docker API access. Run Watchtower on the intended Docker host and connect it through the host’s normal Docker API mechanism. Verify that the service can inspect the containers it is meant to manage.
  2. Label the approved set. Add com.centurylinklabs.watchtower.enable=true only to services with a maintenance and rollback plan. If you are not using label enforcement, document why the broader scope is safe.
  3. Select one timing mode. Use an interval for a repeating cadence or a six-field schedule for a fixed window. Configure only one of the two.
  4. Set the timezone when using cron. Define TZ so the scheduled hour matches the operators’ intended local time.
  5. Start in monitor-only mode. Observe image checks, notifications, and hooks without changing containers. Confirm that the selected services and timing are correct.
  6. Approve the first update window. Remove monitor-only mode during a period when operators can watch logs and verify the application after its restart.
  7. Record the resulting image. Capture the new image reference and configuration so that a known-good state is identifiable.
  8. Decide on cleanup. Enable --cleanup only after a separate rollback method is available. Leave it off if immediate local rollback is more valuable than disk savings.
  9. Review the self-update setting. If Watchtower itself is eligible for updates, do not combine --no-restart and --cleanup without a tested recovery procedure.

Troubleshoot common outcomes

No update happens at the expected time

  • Check that exactly one timing mode is configured. A schedule and interval should not be supplied together.
  • For cron, verify all six fields and confirm that TZ represents the intended timezone.
  • Confirm that the image registry contains a newer image than the one currently used by the container.
  • Check that Watchtower can reach the Docker API and inspect the target container.

The intended service is never selected

If label enforcement is active, inspect the container’s labels and ensure the key is exactly com.centurylinklabs.watchtower.enable with the value true. A service without that label is intentionally excluded.

A container is checked but not changed

Monitor-only mode is designed to produce this result. Remove --monitor-only only after the image and restart have been approved. Also check whether --no-restart is changing the expected activation behavior.

The previous image is unavailable

If cleanup was enabled, Watchtower may have removed the immediately previous local image after replacement. Recover using the separately retained image reference, registry copy, or other rollback method recorded for the service.

Watchtower stops after updating itself

Review whether --no-restart and --cleanup were enabled together. The documented self-update warning describes a renamed Watchtower container remaining without a newly started replacement. Use the manual recovery procedure for the host and revise those options before the next run.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended defaults by environment

Environment Targeting Action Timing Cleanup
Development host All discovered containers only when the host is disposable Automatic updates can be acceptable Interval chosen for the team’s workflow Enable when local disk use is a concern and rollback is easy
Staging Enable-label allow-list Start monitor-only, then apply updates during a staffed window Interval or a scheduled test window Delay until the new image passes checks
Production Enable-label allow-list with sensitive services excluded or monitored only Apply only with an approved restart and rollback plan Six-field cron schedule aligned with maintenance Enable only after an independent rollback path is verified

Bottom line

Watchtower is easiest to operate safely when its permissions and scope are narrow: give it the Docker API access it needs, select either an interval or a six-field cron schedule, and use enable labels as a production allow-list. Monitor-only mode provides a low-risk observation phase. Treat restarts, image cleanup, and Watchtower’s own self-update behavior as explicit operational choices, not defaults to enable blindly.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.