Slack Notifications¶

Deprecated Slack Notification Options

The following legacy Slack notification options are deprecated and subject to removal with the release of Watchtower v2:

Use the notification-url configuration option with a slack:// Shoutrrr URL instead.

Overview¶

Watchtower can use Shoutrrr's Slack service to send Slack notifications.

Examples¶

Docker ComposeDocker CLI

services:
  watchtower:
    image: ghcr.io/sidneyojr/watchtower:latest
    environment:
      WATCHTOWER_NOTIFICATION_URL: "slack://hook:AAAA-BBBB-CCCC@webhook?botname=watchtower"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  ghcr.io/sidneyojr/watchtower \
  --notification-url "slack://hook:AAAA-BBBB-CCCC@webhook?botname=watchtower"

The following legacy Slack configuration options and examples are deprecated and will be removed with the release of Watchtower v2.

Docker CLI (Env Vars)Docker CLI (Flags)Docker Compose

docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e WATCHTOWER_NOTIFICATIONS=slack \
  -e WATCHTOWER_NOTIFICATION_SLACK_HOOK_URL="https://hooks.slack.com/services/xxx/yyyyyyyyyyyyyyy" \
  -e WATCHTOWER_NOTIFICATION_SLACK_IDENTIFIER=watchtower-server-1 \
  -e WATCHTOWER_NOTIFICATION_SLACK_CHANNEL=#my-custom-channel \
  ghcr.io/sidneyojr/watchtower

docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  ghcr.io/sidneyojr/watchtower \
  --notifications slack \
  --notification-slack-hook-url "https://hooks.slack.com/services/xxx/yyyyyyyyyyyyyyy" \
  --notification-slack-identifier watchtower-server-1 \
  --notification-slack-channel "#my-custom-channel"

services:
  watchtower:
    image: ghcr.io/sidneyojr/watchtower:latest
    environment:
      WATCHTOWER_NOTIFICATIONS: slack
      WATCHTOWER_NOTIFICATION_SLACK_HOOK_URL: "https://hooks.slack.com/services/xxx/yyyyyyyyyyyyyyy"
      WATCHTOWER_NOTIFICATION_SLACK_IDENTIFIER: watchtower-server-1
      WATCHTOWER_NOTIFICATION_SLACK_CHANNEL: "#my-custom-channel"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock