<div align="center">
# Watchtower
A process for automating Docker container base image updates.
<br/><br/>
[](https://circleci.com/gh/containrrr/watchtower)
[](https://codecov.io/gh/containrrr/watchtower)
[](https://godoc.org/github.com/containrrr/watchtower)
[](https://microbadger.com/images/containrrr/watchtower)
[](https://goreportcard.com/report/github.com/containrrr/watchtower)
[](https://github.com/containrrr/watchtower/releases)
[](https://www.apache.org/licenses/LICENSE-2.0)
[](https://www.codacy.com/gh/containrrr/watchtower/dashboard?utm_source=github.com&utm_medium=referral&utm_content=containrrr/watchtower&utm_campaign=Badge_Grade)
[](#contributors)
[](https://hub.docker.com/r/containrrr/watchtower)
</div>
## 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 -d \
--name watchtower \
-v /var/run/docker.sock:/var/run/docker.sock \
containrrr/watchtower
```
## Documentation
The full documentation is available at https://containrrr.dev/watchtower.
## Contributors
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
<tr>
<td align="center"><a href="http://codelica.com" rel='nofollow' onclick='return false;'><img src="https://avatars3.githubusercontent.com/u/386101?v=4?s=100" width="100px;" alt=""/><br /><sub><b>James</b></sub></a><br /><a href="https://github.com/containrrr/watchtower/commits?author=Codelica" title="Tests" rel='nofollow' onclick='return false;'>â ï¸</a> <a href="#ideas-Codelica" title="Ideas, Planning, & Feedback" rel='nofollow' onclick='return false;'>ð¤</a></td>
<td align="center"><a href="https://kopfkrieg.org" rel='nofollow' onclick='return false;'><img src="https://avatars2.githubusercontent.com/u/5047813?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Florian</b></sub></a><br /><a href="https://github.com/containrrr/watchtower/pulls?q=is%3Apr+reviewed-by%3AKopfKrieg" title="Reviewed Pull Requests" rel='nofollow' onclick='return false;'>ð</a> <a href="https://github.com/containrrr/watchtower/commits?author=KopfKrieg" title="Documentation" rel='nofollow' onclick='return false;'>ð</a></td>
<td align="center"><a href="https://github.com/bdehamer" rel='nofollow' onclick='return false;'><img src="https://avatars1.githubusercontent.com/u/398027?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Brian DeHamer</b></sub></a><br /><a href="https://github.com/containrrr/watchtower/commits?author=bdehamer" title="Code" rel='nofollow' onclick='return false;'>ð»</a> <a href="#maintenance-bdehamer" title="Maintenance" rel='nofollow' onclick='return false;'>ð§</a></td>
<td align="center"><a href="https://github.com/rosscado" rel='nofollow' onclick='return false;'><img src="https://avatars1.githubusercontent.com/u/16578183?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ross Cadogan</b></sub></a><br /><a href="https://github.com/containrrr/watchtower/commits?author=rosscado" title="Code" rel='nofollow' onclick='return false;'>ð»</a></td>
<td align="center"><a href="https://github.com/stffabi" rel='nofollow' onclick='return false;'><img src="https://avatars0.githubusercontent.com/u/9464631?v=4?s=100" width="100px;" alt=""/><br /><sub><b>stffabi</b></sub></a><br /><a href="https://github.com/containrrr/watchtower/commits?author=stffabi" title="Code" rel='nofollow' onclick='return false;'>ð»</a> <a href="#maintenance-stffabi" title="Maintenance" rel='nofollow' onclick='return false;'>ð§</a></td>
<td align="center"><a href="https://github.com/ATCUSA" rel='nofollow' onclick='return false;'><img src="https://avatars3.githubusercontent.com/u/3581228?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Austin</b></sub></a><br /><a href="https://github.com/containrrr/watchtower/commits?author=ATCUSA" title="Documentation" rel='nofollow' onclick='return false;'>ð</a></td>
<td align="center"><a href="https://labs.ctl.io" rel='nofollow' onclick='return false;'><img src="https://avatars2.githubusercontent.com/u/6181487?v=4?s=100" width="100px;" alt=""/><br /><sub><b>David Gardner</b></sub></a><br /><a href="https://github.com/containrrr/watchtower/pulls?q=is%3Apr+reviewed-by%3Adavidgardner11" title="Reviewed Pull Requests" rel='nofollow' onclick='return false;'>ð</a> <a href="https://github.com/containrrr/watchtower/commits?author=davidgardner11" title="Documentation" rel='nofollow' onclick='return false;'>ð</a></td>
</tr>
<tr>
<td align="center"><a href="https://github.com/dolanor" rel='nofollow' onclick='return false;'><img src="https://avatars3.githubusercontent.com/u/928722?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Tanguy â§ Herrmann</b></sub></a><br /><a href="https://github.com/containrrr/watchtower/commits?author=dolanor" title="Code" rel='nofollow' onclick='return false;'>ð»</a></td>
<td align="center"><a href="https://github.com/rdamazio" rel='nofollow' onclick='return false;'><img src="https://avatars3.githubusercontent.com/u/997641?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Rodrigo Damazio Bovendorp</b></sub></a><br /><a href="https://github.com/containrrr/watchtower/commits?author=rdamazio" title="Code" rel='nofollow' onclick='return false;'>ð»</a> <a href="https://github.com/containrrr/watchtower/commits?author=rdamazio" title="Documentation" rel='nofollow' onclick='return false;'>ð</a></td>
<td align="center"><a href="https://www.taisun.io/" rel='nofollow' onclick='return false;'><img src="https://avatars3.githubusercontent.com/u/1852688?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ryan Kuba</b></sub></a><br /><a href="#infra-thelamer" title="Infrastructure (Hosting, Build-Tools, etc)" rel='nofollow' onclick='return false;'>ð</a></td>
<td align="center"><a href="https://github.com/cnrmck" rel='nofollow' onclick='return false;'><img src="https://avatars2.githubusercontent.com/u/22061955?v=4?s=100" width="100px;" alt=""/><br /><sub><b>cnrmck</b></sub></a><br /><a href="https://github.com/containrrr/watchtower/commits?author=cnrmck" title="Documentation" rel='nofollow' onclick='return false;'>ð</a></td>
<td align="center"><a href="http://harrywalter.co.uk" rel='nofollow' onclick='return false;'><img src="https://avatars3.githubusercontent.com/u/338588?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Harry Walter</b></sub></a><br /><a href="https://github.com/containrrr/watchtower/commits?author=haswalt" title="Code" rel='nofollow' onclick='return false;'>ð»</a></td>
<td align="center"><a href="http://projectsperanza.com" rel='nofollow' onclick='return false;'><img src="https://avatars3.githubusercontent.com/u/74515?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Robotex</b></sub></a><br /><a href="https://github.com/containrrr/watchtower/commits?author=Robotex" title="Documentation" rel='nofollow' onclick='return false;'>ð</a></td>
<td align="center"><a href="http://geraldpape.io" rel='nofollow' onclick='return false;'><img src="https://avatars0.githubusercontent.com/u/1494211?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Gerald Pape</b></sub></a><br /><a href="https://github.com/containrrr/watchtower/commits?author=ubergesundheit" title="Documentation" rel='nofollow' onclick='return false;'>ð</a></td>
</tr>
<tr>
<td align="center"><a href="https://github.com/fomk" rel='nofollow' onclick='return false;'><img src="https://avatars0.githubusercontent.com/u/17636183?v=4?s=100" width="100px;" alt=""/><br /><sub><b>fomk</b></sub></a><br /><a href="https://github.com/containrrr/watchtower/commits?author=fomk" title="Code" rel='nofollow' onclick='return false;'>ð»</a></td>
<td align="center"><a href="https://github.com/svengo" rel='nofollow' onclick='return false;'><img src="https://avatars3.githubusercontent.com/u/2502366?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Sven Gottwald</b></sub></a><br /><a href="#infra-svengo" title="Infrastructure (Hosting, Build-Tools, etc)" rel='nofollow' onclick='return false;'>ð</a></td>
<td align="center"><a href="https://liberapay.com/techknowlogic