# Watchtower A process for automating Docker container base image updates.

[![Circle CI](https://circleci.com/gh/containrrr/watchtower.svg?style=shield)](https://circleci.com/gh/containrrr/watchtower) [![codecov](https://codecov.io/gh/containrrr/watchtower/branch/main/graph/badge.svg)](https://codecov.io/gh/containrrr/watchtower) [![GoDoc](https://godoc.org/github.com/containrrr/watchtower?status.svg)](https://godoc.org/github.com/containrrr/watchtower) [![Go Report Card](https://goreportcard.com/badge/github.com/containrrr/watchtower)](https://goreportcard.com/report/github.com/containrrr/watchtower) [![latest version](https://img.shields.io/github/tag/containrrr/watchtower.svg)](https://github.com/containrrr/watchtower/releases) [![Apache-2.0 License](https://img.shields.io/github/license/containrrr/watchtower.svg)](https://www.apache.org/licenses/LICENSE-2.0) [![Codacy Badge](https://app.codacy.com/project/badge/Grade/1c48cfb7646d4009aa8c6f71287670b8)](https://www.codacy.com/gh/containrrr/watchtower/dashboard?utm_source=github.com&utm_medium=referral&utm_content=containrrr/watchtower&utm_campaign=Badge_Grade) [![All Contributors](https://img.shields.io/github/all-contributors/containrrr/watchtower)](#contributors) [![Pulls from DockerHub](https://img.shields.io/docker/pulls/containrrr/watchtower.svg)](https://hub.docker.com/r/containrrr/watchtower)
## 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 \ containrrr/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. If that feels like too big a step for you, please look into solutions like [MicroK8s](https://microk8s.io/) and [k3s](https://k3s.io/) that take away a lot of the toil of running a Kubernetes cluster. ## 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)):
nils mΓ₯sΓ©n
nils mΓ₯sΓ©n

πŸ’» πŸ“– 🚧 πŸ‘€
Simon Aronsson
Simon Aronsson

πŸ’» πŸ“– 🚧 πŸ‘€
James
James

⚠️ πŸ€”
Florian
Florian

πŸ‘€ πŸ“–
Brian DeHamer
Brian DeHamer

πŸ’» 🚧
Ross Cadogan
Ross Cadogan

πŸ’»
stffabi
stffabi

πŸ’» 🚧
Austin
Austin

πŸ“–
David Gardner
David Gardner

πŸ‘€ πŸ“–
Tanguy ⧓ Herrmann
Tanguy ⧓ Herrmann

πŸ’»
Rodrigo Damazio Bovendorp
Rodrigo Damazio Bovendorp

πŸ’» πŸ“–
Ryan Kuba
Ryan Kuba

πŸš‡
cnrmck
cnrmck

πŸ“–
Harry Walter
Harry Walter

πŸ’»
Robotex
Robotex

πŸ“–
Gerald Pape
Gerald Pape

πŸ“–
fomk
fomk

πŸ’»
Sven Gottwald
Sven Gottwald

πŸš‡
techknowlogick
techknowlogick

πŸ’»
waja
waja

πŸ“–
Scott Albertson
Scott Albertson

πŸ“–
Jason Huddleston
Jason Huddleston

πŸ“–
Napster
Napster

πŸ’»
Maxim
Maxim

πŸ’» πŸ“–
Max Schmitt
Max Schmitt

πŸ“–
cron410
cron410

πŸ“–
Paulo Henrique
Paulo Henrique

πŸ“–
Kaleb Elwert
Kaleb Elwert

πŸ“–
Bill Butler
Bill Butler

πŸ“–
Mario Tacke
Mario Tacke

πŸ’»
Mark Woodbridge
Mark Woodbridge

πŸ’»
Ansem93
Ansem93

πŸ“–
Luka Peschke
Luka Peschke

πŸ’» πŸ“–
Zois Pagoulatos
Zois Pagoulatos

πŸ’» πŸ‘€ 🚧
Alexandre Menif
Alexandre Menif

πŸ’»
Andrey
Andrey

πŸ“–
Armando LΓΌscher
Armando LΓΌscher

πŸ“–
Ryan Budke
Ryan Budke

πŸ“–
Kaloyan Raev
Kaloyan Raev

πŸ’» ⚠️
sixth
sixth

πŸ“–
Gina HÀußge
Gina HÀußge

πŸ’»
Max H.
Max H.

πŸ’»
Jungkook Park
Jungkook Park

πŸ“–
Jan Kristof Nidzwetzki
Jan Kristof Nidzwetzki

πŸ“–
lukas
lukas

πŸ’»
Ameya Shenoy
Ameya Shenoy

πŸ’»
Raymon de Looff
Raymon de Looff

πŸ’»
John Clayton
John Clayton

πŸ’»
Germs2004
Germs2004

πŸ“–
Lukas Willburger
Lukas Willburger

πŸ’»
Oliver Cervera
Oliver Cervera

πŸ“–
Victor Moura
Victor Moura

⚠️ πŸ’» πŸ“–
Maximilian Brandau
Maximilian Brandau

πŸ’» ⚠️
Andrew
Andrew

πŸ“–
sixcorners
sixcorners

πŸ“–
Arne JΓΈrgensen
Arne JΓΈrgensen

⚠️ πŸ‘€
PatSki123
PatSki123

πŸ“–
Valentine Zavadsky
Valentine Zavadsky

πŸ’» πŸ“– ⚠️
Alexander Voronin
Alexander Voronin

πŸ’» πŸ›
Oliver Mueller
Oliver Mueller

πŸ“–
Sebastiaan Tammer
Sebastiaan Tammer

πŸ’»
miosame
miosame

πŸ“–
Andrew Metzger
Andrew Metzger

πŸ› πŸ’‘
Pierre Grimaud
Pierre Grimaud

πŸ“–
Matt Doran
Matt Doran

πŸ“–
MihailITPlace
MihailITPlace

πŸ’»
bugficks
bugficks

πŸ’» πŸ“–
Michael
Michael

πŸ’»
D. Domig
D. Domig

πŸ“–
Ben Osheroff
Ben Osheroff

πŸ’»
David H.
David H.

πŸ’»
Chander Ganesan
Chander Ganesan

πŸ“–
yrien30
yrien30

πŸ’»
ksurl
ksurl

πŸ“– πŸ’» πŸš‡
rg9400
rg9400

πŸ’»
Turtle Kalus
Turtle Kalus

πŸ’»
Srihari Thalla
Srihari Thalla

πŸ“–
Thomas Gaudin
Thomas Gaudin

πŸ“–
hydrargyrum
hydrargyrum

πŸ“–
Reinout van Rees
Reinout van Rees

πŸ“–
DasSkelett
DasSkelett

πŸ’»
zenjabba
zenjabba

πŸ“–
Dan Quan
Dan Quan

πŸ“–
modem7
modem7

πŸ“–
Igor Zibarev
Igor Zibarev

πŸ’»
Patrice
Patrice

πŸ’»
James White
James White

πŸ“–
Dirk Kok
Dirk Kok

πŸ’»
EDIflyer
EDIflyer

πŸ“–
Jauder Ho
Jauder Ho

πŸ’»
Tamal Das
Tamal Das

πŸ“–
guangwu
guangwu

πŸ“–
Florian HΓΌbner
Florian HΓΌbner

πŸ“–
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!