Quick Start

With watchtower you can update the running version of your containerized app simply by pushing a new image to the Docker Hub or your own image registry.

Watchtower will pull down your new image, gracefully shut down your existing container and restart it with the same options that were used when it was deployed initially. Run the watchtower container with the following command:

$ docker run --detach \
    --name watchtower \
    --volume /var/run/docker.sock:/var/run/docker.sock \
    nickfedor/watchtower

Watchtower is intended to be used in homelabs, media centers, local dev environments, and similar. We do not recommend using Watchtower in a commercial or production environment. If that is you, you should be looking into using Kubernetes enabled with CI/CD, such as onedr0p's Talos Linux with FluxCD setup here.

⚠️ Note: It is recommended to use the latest version of Docker. You can check your host's Docker version using the CLI command docker version. This version of Watchtower has been tested to support v1.43 and higher; however, don't be surprised if you experience unexpected behavior when attempting to use newer features on older versions of Docker. This version autonegotiates the API version by default. If the DOCKER_API_VERSION variable is explicitly set, Watchtower validates the version and falls back to autonegotiation on failure.

Supported Architectures

Watchtower supports the following architectures for its Docker images:

• amd64
• i386
• armhf
• arm64v8
• riscv64

Documentation

The full documentation is available at https://watchtower.nickfedor.com/.

Star History

Contributors

Thanks goes to these wonderful people (emoji key):

Nicholas Fedor 💻 📖 🚧 👀	Dirk Kok 💻	nils måsén 💻 📖 🚧 👀	Simon Aronsson 💻 📖 🚧 👀	James ⚠️ 🤔	Florian 👀 📖	Brian DeHamer 💻 🚧
Ross Cadogan 💻	stffabi 💻 🚧	Austin 📖	David Gardner 👀 📖	Tanguy ⧓ Herrmann 💻	Rodrigo Damazio Bovendorp 💻 📖	Ryan Kuba 🚇
cnrmck 📖	Harry Walter 💻	Robotex 📖	Gerald Pape 📖	fomk 💻	Sven Gottwald 🚇	techknowlogick 💻
waja 📖	Scott Albertson 📖	Jason Huddleston 📖	Napster 💻	Maxim 💻 📖	Max Schmitt 📖	cron410 📖
Paulo Henrique 📖	Kaleb Elwert 📖	Bill Butler 📖	Mario Tacke 💻	Mark Woodbridge 💻	Ansem93 📖	Luka Peschke 💻 📖
Zois Pagoulatos 💻 👀 🚧	Alexandre Menif 💻	Andrey 📖	Armando Lüscher 📖	Ryan Budke 📖	Kaloyan Raev 💻 ⚠️	sixth 📖
Gina Häußge 💻	Max H. 💻	Jungkook Park 📖	Jan Kristof Nidzwetzki 📖	lukas 💻	Ameya Shenoy 💻	Raymon de Looff 💻
John Clayton 💻	Germs2004 📖	Lukas Willburger 💻	Oliver Cervera 📖	Victor Moura ⚠️ 💻 📖	Maximilian Brandau 💻 ⚠️	Andrew 📖
sixcorners 📖	Arne Jørgensen ⚠️ 👀	PatSki123 📖	Valentine Zavadsky 💻 📖 ⚠️	Alexander Voronin 💻 🐛	Oliver Mueller 📖	Sebastiaan Tammer 💻
miosame 📖	Andrew Metzger 🐛 💡	Pierre Grimaud 📖	Matt Doran 📖	MihailITPlace 💻	bugficks 💻 📖	Michael 💻
D. Domig 📖	Ben Osheroff 💻	David H. 💻	Chander Ganesan 📖	yrien30 💻	ksurl 📖 💻 🚇	rg9400 💻
Turtle Kalus 💻	Srihari Thalla 📖	Thomas Gaudin 📖	hydrargyrum 📖	Reinout van Rees 📖	DasSkelett 💻	zenjabba 📖
Dan Quan 📖	modem7 📖	Igor Zibarev 💻	Patrice 💻	James White 📖	EDIflyer 📖	Jauder Ho 💻
Andrii Bratanin 📖	Tamal Das 📖	guangwu 📖	Florian Hübner 📖 💻	yubiuser 💻	RoboMagus 🚇	AzariasB 📖
ApprenticeofEnder 💻	skylenet 💻	Varun Chawla 💻	LJspice 💻	Barnabas Busa 💻 📖	Matthias Thubauville 📖	Gauthier Painteaux 💻 ⚠️ 📖
粒粒橙 💻	ncrosty58 💻	Justin Montgomery 🐛 💻	shawly 💻	Nota Inutilis 📖	Stan 💻 ⚠️

This project follows the all-contributors specification. Contributions of any kind welcome!