Watchtower#

Watchtower A process for automating Docker container base image updates

amd64
arm64
armv7

Information#

Docker Image: !!! LINK TO DOCKER IMAGE/ DOCKER HUB !!!
Current Image Version: latest

SETUP#

Enabling watchtower#

Command:#

vlab set watchtower.enable True

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

watchtower
enable: True

Finalising changes:#

run: vlab update_one service=watchtower

FIRST RUN#

Default#

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.

Example: go to /home/root/vivumlab/watchtower/ and run cp docker-compose.yml docker-compose.override.yml (This creates the override file for you.). Then edit the file and delete everything that is already in the docker-compose.yml file that you don't want to customize.

from this

---
version: '3'
services:
watchtower:
image: containrrr/watchtower
restart: unless-stopped
volumes:
- /var/run/docker.sock:/var/run/docker.sock
#- "/home/root/vivumlab/watchtower/config.json:/config.json:rw" # Only needed for Private registries
command: --schedule "0 2 * * *" --cleanup --stop-timeout 30s
environment:
- TZ=Europe/Berlin

to this

---
version: '3'
services:
watchtower:

next you want to add a label

---
version: '3'
services:
watchtower:
labels:
- com.centurylinklabs.watchtower.enable=false

Run systemctl restart watchtower

Now the automatic update for the watchtower image is disabled.

SMTP/ MAIL#

  1. run vlab decrypt to decrypt the vault.yml file
  2. make some changes

SMTP Settings#

smtp:
host:
port:
user:
pass:
from_email:
from_name:
  1. run vlab update_one service=watchtower to complete the changes

Access#

Watchtower has no web interface.

OPTIONS#

HTTPS_ONLY#

Default: False
Options: True/False

Command:#

vlab set watchtower.https_only True

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

watchtower
https_only: True
Finalising changes:#

run: vlab update_one service=watchtower

AUTH#

Default: False
Options: True/False

Command:#

vlab set watchtower.auth True

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

watchtower
auth: True
Finalising changes:#

run: vlab update_one service=watchtower

DOMAIN#

Default: False
NOTE: include the sitename and top level domain suffix. eg. name.com, site.net

Command:#

vlab set watchtower.domain watchtower.com

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

watchtower
domain: watchtower.com
Finalising changes:#

run: vlab update_one service=watchtower

SUBDOMAIN#

Default: watchtower
NOTE: Periods/ delimiters are not required. eg. 'media' will set the full URL as 'media.vivumlab.xyz'

Command:#

vlab set watchtower.subdomain media

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

watchtower
subdomain: media
Finalising changes:#

run: vlab update_one service=watchtower

VERSION#

Default: latest
NOTE: Ensure that the version exists

Command:#

vlab set watchtower.version 2.7

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

watchtower
version: 2.7
Finalising changes:#

run: vlab update_one service=watchtower

Need more help?#

Further information regarding services can be found.
General Information can be found in the documentation.
Additional assistance can be found on our Contact Us page.