mirror of
https://github.com/containrrr/watchtower.git
synced 2025-12-14 14:10:12 +01:00
6a18ee911e
* Adds scopeUID config to enable multiple instances of Watchtower * Adds tests for multiple instance support with scopeuid * Adds docs on scope monitoring and multiple instance support * Adds multiple instances docs to mkdocs config file * Changes multiple instances check and refactors naming for scope feature * Applies linter suggestions * Fixes documentation on Watchtower monitoring scope
31 lines
No EOL
1.7 KiB
Markdown
31 lines
No EOL
1.7 KiB
Markdown
By default, watchtower will watch all containers. However, sometimes only some containers should be updated.
|
|
|
|
If you need to exclude some containers, set the _com.centurylinklabs.watchtower.enable_ label to `false`.
|
|
|
|
```docker
|
|
LABEL com.centurylinklabs.watchtower.enable="false"
|
|
```
|
|
|
|
Or, it can be specified as part of the `docker run` command line:
|
|
|
|
```bash
|
|
docker run -d --label=com.centurylinklabs.watchtower.enable=false someimage
|
|
```
|
|
|
|
If you need to [include only containers with the enable label](https://containrrr.github.io/watchtower/arguments/#filter_by_enable_label), pass the `--label-enable` flag or the `WATCHTOWER_LABEL_ENABLE` environment variable on startup and set the _com.centurylinklabs.watchtower.enable_ label with a value of `true` for the containers you want to watch.
|
|
|
|
```docker
|
|
LABEL com.centurylinklabs.watchtower.enable="true"
|
|
```
|
|
|
|
Or, it can be specified as part of the `docker run` command line:
|
|
|
|
```bash
|
|
docker run -d --label=com.centurylinklabs.watchtower.enable=true someimage
|
|
```
|
|
|
|
If you wish to create a monitoring scope, you will need to [run multiple instances and set a scope for each of them](https://containrrr.github.io/watchtower/running-multiple-instances).
|
|
|
|
Watchtower filters running containers by testing them against each configured criteria. A container is monitored if all criteria are met. For example:
|
|
- If a container's name is on the monitoring name list (not empty `--name` argument) but it is not enabled (_centurylinklabs.watchtower.enable=false_), it won't be monitored;
|
|
- If a container's name is not on the monitoring name list (not empty `--name` argument), even if it is enabled (_centurylinklabs.watchtower.enable=true_ and `--label-enable` flag is set), it won't be monitored; |