Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/containrrr/watchtower

A process for automating Docker container base image updates.
https://github.com/containrrr/watchtower

automation continuous-delivery devops docker hacktoberfest notifications receive-notifications registry update-checker watchtower

Last synced: 11 days ago
JSON representation

A process for automating Docker container base image updates.

Host: GitHub
URL: https://github.com/containrrr/watchtower
Owner: containrrr
License: apache-2.0
Created: 2015-07-13T21:21:53.000Z (over 9 years ago)
Default Branch: main
Last Pushed: 2024-07-30T08:12:03.000Z (3 months ago)
Last Synced: 2024-09-30T21:02:28.644Z (about 1 month ago)
Topics: automation, continuous-delivery, devops, docker, hacktoberfest, notifications, receive-notifications, registry, update-checker, watchtower
Language: Go
Homepage: https://containrrr.dev/watchtower/
Size: 17.2 MB
Stars: 18,769
Watchers: 137
Forks: 841
Open Issues: 170
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: code_of_conduct.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md

Awesome Lists containing this project

awesome - containrrr/watchtower - A process for automating Docker container base image updates. (Go)
stars - containrrr/watchtower
awesome - containrrr/watchtower - A process for automating Docker container base image updates. (Go)
DevSecOps - https://github.com/containrrr/watchtower - the-badge) | (Containers)
awesome-modern-devops - Watchtower - A tool for automating Docker container base image updates. (Containers)
awesome-repositories - containrrr/watchtower - A process for automating Docker container base image updates. (Go)
awesome-starred - watchtower - A process for automating Docker container base image updates. (Go)
awesome-list - watchtower
awesome-starred - containrrr/watchtower - A process for automating Docker container base image updates. (hacktoberfest)
awesome-docker - Watchtower - Automatically update running Docker containers (Development with Docker / CI/CD)
awesome-gitea - watchtower - A process for automating Docker container base image updates. Useful for running Continuous Deployment pipeline steps. (Applications / DevOps)
awesome-docker - Watchtower - Automatically update running Docker containers (Development with Docker / CI/CD)
StarryDivineSky - containrrr/watchtower
awesome-starts - containrrr/watchtower - A process for automating Docker container base image updates. (hacktoberfest)
my-awesome - containrrr/watchtower - delivery,devops,docker,hacktoberfest,notifications,receive-notifications,registry,update-checker,watchtower pushed_at:2024-07 star:19.3k fork:0.9k A process for automating Docker container base image updates. (Go)
awesome-hacktoberfest - watchtower - A process for automating Docker container base image updates. (Projects friendly to Hacktoberfest 1st time contributors / Go)
awesome - containrrr/watchtower - A process for automating Docker container base image updates. (hacktoberfest)

README

        


  

  

  # 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}
💻 📖 🚧 👀

      
_{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}
📖

      
_{Dirk Kok}
💻

      
_EDIflyer
📖

      
_{Jauder Ho}
💻

      
_{Tamal Das}
📖

    

    

      
_guangwu
📖

      
_{Florian Hübner}
📖 💻

      
_{Andrii Bratanin}
📖

    

  

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