Notify

Configure global notifiers that can be used by any Service.

We are running Shoutrrr 0.8, which supports sending notifications to the services listed below.

The ‘URL Fields’ go under url_fields and ‘Query/Param Props’ go under params.

Below I have used capitals in some key naming for better readability (ignore that Argus will convert that to lower-case as it shouldn’t break anything).

The lines prefixed with a # are optional vars that aren’t required.

Note

Environment variables in the format '${ENV_VAR}' can be used in the `options.*`, `params.*` and `url_fields.*` fields.

The config for each of these is laid out in the format of

notify:
  ...
  # As many of these (below) as you like, just ensure they have unique ID's
  EXAMPLE_NOTIFY_ID:
    type: gotify
    options:
#     delay: AhBmCs                             # Time to wait when a new release is found before sending this message
#     max_tries: 3                              # Maximum number of times to try sending this message until a send is successful
#     message: >-                               # Message template
#       <{{ service_url }}|{{ service_id }}> -
#       {{ version }} released{% if web_url %}
#       (<{{ web_url }}|changelog>){% endif %}
    url_fields: {}
    params: {}

where the vars available in options stay the same every time (so they’ll be omitted below).

message templating

The message used in the Notify messages can be customised with Django-style templating courtesy of pongo2.

The default message template is <{{ service_url }}|{{ service_id }}> - {{ version }} released{% if web_url %} (<{{ web_url }}|changelog>){% endif %} , which with a service_id of ’example_service’, a service_url of ’example.com’, no web_url and the version that triggered this message being ‘1.2.3’, would trigger a message of example_service - 1.2.3 released (example_service would be a clickable link to the service_url). If the Service had a web_url defined, then ’ (changelog)’ would appear at the end, where the ‘changelog’ text would be a clickable link to that web_url.

The vars that can be used in both the title and message templates are:

service_id
service_name
service_url
icon
icon_link_to
web_url
latest_version
approved_version
deployed_version
tags (e.g. tags | join',' - use tags.0 for first element, tags.1 for seconds, etc.)

The default Slack message format assumes that when web_url is defined, it is a link to the services changelog. Then, in any notifications by Argus about that service, you should get a clickable ‘changelog’ button that takes you to that web_url.

For further guidance and other helpful examples on the templating used, start by looking here.

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: bark
    url_fields:
      DeviceKey: DEVICE_KEY
      Host: your_host
#     Path: /foo
#   params:
#     Badge: 0                           # Number displayed next to App icon
#     Copy: foo                          # Value to be copied
#     Group: admins                      # Group of the notification
#     Icon: https://example.com/icon.png # URL to an image
#     Scheme: http/https                 # Server protocol
#     Sound: ''                          # From https://github.com/Finb/Bark/tree/master/Sounds
#     Title: Release                     # Notification title
#     URL: https://example.com           # URL to open when notification is tapped

As of writing, Discord Webhooks are in the format of https://discord.com/api/webhooks/WEBHOOK_ID/TOKEN (<Server Settings> - <Integrations> - <Webhooks>)

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: discord
    url_fields:
      Token: TOKEN
      WebhookID: WEBHOOK_ID
#   params:
#     Avatar: https://release-argus.io/favicons/android-chrome-512x512.png
#                          # Override the webhook default avatar with specified URL
#     Color: 0x50D9ff      # The color of the left border for plain messages
#     ColorDebug: 0x7b00ab # The color of the left border for debug messages
#     ColorError: 0xd60510 # The color of the left border for error messages
#     ColorInfo: 0x2488ff  # The color of the left border for info messages
#     ColorWarn: 0xffc441  # The color of the left border for warning messages
#     JSON: no             # Whether to send the whole message as the JSON payload instead of using it as the 'content' field
#     SplitLines: yes      # Whether to send each line as a separate embedded item
#     ThreadID: ''         # The thread ID to send the message to
#     Title: Release       # Notification title
#     Username: Argus      # Override the webhook default username

email notifications

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: smtp
    url_fields:
#     Username: NAME
#     Password: PASSWORD123
      Host: your_host
#     Port: 25
    params:
      FromAddress: foo@bar.com                # E-mail address that the mail are sent from
#     FromName: Argus                         # Name of the sender
      ToAddresses: name@you.com,other@you.com # List of recipient e-mails (comma-separated)
#     Auth: Plain                             # SMTP authentication method - None/Plain/CRAMMD5/Unknown/OAuth2
#     ClientHost: ''                          # SMTP client hostname
#     Encryption: Auto                        # Encryption method - None/ExplicitTLS/ImplicitTLS/Auto
#     Subject: '{{ service_id }} Release'     # The subject of the sent mail
#     UseHTML: no                             # Whether the message being sent is in HTML
#     UseStartTLS: yes                        # Whether to use StartTLS encryption
#     RequireStartTLS: no                     # Fail if StartTLS is enabled but unsupported
#     SkipTLSVerify: no                       # Whether to skip TLS certificate verification

Example Google Chat incoming Webhook URL https://chat.googleapis.com/v1/spaces/ FOO /messages?key= bar &token= baz

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: googlechat
    url_fields:
      Raw: chat.googleapis.com/v1/spaces/FOO/messages?key=bar&token=baz

Create an application on the Gotify Web UI, and use that URL with the token for the application you make.

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: gotify
    url_fields:
      Host: gotify.example.io
#     Port: 443
#     Path: sub/path          # e.g. for gotify.example.io/sub/path
      Token: TOKEN
#   params:
#     Extras: ''
#     Date: ''
#     DisableTLS: no          # Disable TLS certificate verification
#     InsecureSkipVerify:: no # Whether to skip TLS certificate verification
#     Priority: 0
#     Title: Argus            # Notification title
#     UseHeader:: no          # Enable header-based authentication

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: ifttt
    url_fields:
      WebhookID: WEBHOOK_ID
    params:
      Events: event1,event2,...
#     Title: Argus              # Notification title
#     UseMessageAsValue: 2      # Sets the corresponding value field to the notification message
#     UseTitleAsValue: 0        # Sets the corresponding value field to the notification title
#     Value1: ''
#     Value2: ''
#     Value3: ''

Go to the Join Webapp
Select your device
Click Join API
Your deviceId is shown in the top
Click Show next to API Key to see your key

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: join
    url_fields:
      APIKey: KEY
    params:
      Devices: ID1,ID2,... # Comma separated list of device IDs
#     Icon: https://release-argus.io/favicons/android-chrome-512x512.png
#                          # Icon URL
#     Title: Argus         # Notification title

Go to the menu in the top left and navigate to <Integrations> - <Incoming Webhooks>.

Example Mattermost Webhook - https://mattermost.example.io/hooks/TOKEN

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: mattermost
    url_fields:
#     Username: Argus
      Host: mattermost.example.io
#     Port: 443
#     Path: sub/path              # e.g. for mattermost.example.io/sub/path/hooks/TOKEN
      Token: TOKEN
#     Channel: releases
#   params:
#     DisableTLS: no # Disable TLS certificate verification
#     Icon: https://release-argus.io/favicons/android-chrome-512x512.png
#                    # Use emoji or URL as icon (based on presence of http(s):// prefix)

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: matrix
    url_fields:
#     User: NAME
      Password: PASS123
      Host: matrix.example.io
#     Port: 443
#   params:
#     DisableTLS: no          # Disable TLS certificate verification
#     Rooms: '!ROOM_ID,ALIAS' # Room aliases, or with ! prefix, room IDs (Needs the quotes as `!` is a YAML special character)
#     Title: Argus            # Notification title

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: ntfy
    url_fields:
#     Username: Argus
#     Password: PASS123           # username not required when using an access token (e.g. 'tk_xxxxxxxx')
      Host: mattermost.example.io
#     Port: 443
      Topic: Release123
#   params:
#     Actions: ''                        # see https://docs.ntfy.sh/publish/#action-buttons
#     Attach: https://example.com        # URL of an attachment
#     Cache: yes                         # Cache messages
#     Click: https://example.com         # Website opened when notification is clicked
#     DisableTLS: no                     # Disable TLS certificate verification
#     Email: name@example                # Email address for email notifications
#     Filename: ''                       # Filename for attachment
#     Firebase: yes                      # Send to Firebase
#     Icon: https://example.com/icon.png # URL to an icon
#     Priority: default                  # Priority of the notification - min/low/default/high/max
#     Scheme: https                      # Server protocol - http/https
#     Tags: ''                           # Comma separated list of tags that may/may not map to emojis
#     Title: Argus                       # Notification title

Go to <Settings> - <Integration List> - <API>

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: opsgenie
    url_fields:
#     Host: api.opsgenie.com # e.g. api.eu.opsgenie.com for EU instances
#     Port: 443
      APIKey: API_KEY
#   params:
#     Actions: 'An action'                        # Custom actions that will be available for the alert
#     Alias: 'alias for the alert'                # Client-defined identifier of the alert
#     Description: 'Argus found a new release'    # Description field of the alert
#     Details: '{"key1": "val1", "key2": "val2"}' # Map of key-value pairs to use as custom properties of the alert
#     Entity: 'Example entity'                    # Entity field of the alert that is generally used to specify which
#                                                 # domain the Source field of the alert
#     Note: 'Note on Argus'                       # Additional note that will be added while creating the alert
#     Priority: 'P1'                              # Priority level of the alert. Possible values are P1/P2/P3/P4/P5
#     Responders: '[{"id":"4513b7ea-3b91-438f-b7e4-e3e54af9147c","type":"team"},{"name":"NOC","type":"team"}]'
#                                                 # Teams, users, escalations and schedules that the alert will be
#                                                 # routed to send
#     Source: 'Argus'                             # Source field of the alert
#     Tags: 'argus othertag'                      # Tags of the alert
#     Title: 'Argus'                              # Notification title
#     User: 'Argus'                               # Display name of the request owner
#     VisibleTo: '[{"id":"4513b7ea-3b91-438f-b7e4-e3e54af9147c","type":"team"},{"name":"rocket_team","type":"team"}]'
#                                                 # Teams and users that the alert will become visible to without
#                                                 # sending any notification

Get your token by creating an Access Token at https://www.pushbullet.com/#settings/account
Get your targets by going to https://www.pushbullet.com/#devices. Click on the device on the left pane and the URL should change to https://www.pushbullet.com/#devices/<TARGET>

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: pushbullet
    url_fields:
      Token: ACCESS_TOKEN
      Targets: DEVICE1,DEVICE2
#   params:
#     Title: Argus # Notification title

To get your <User Key>, go to your Pushover dashboard, and view it at the top right.

You can also make an Application specific for Argus by clicking ‘Create an Application/API Token’ at the bottom of that dashboard

In the device list, the Name column is the field used to refer to your devices

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: pushover
    url_fields:
      Token: TOKEN
      User: USER_KEY # User Key OR API Token/Key
#   params:
#     Devices: 'device1,device2'
#     Priority: 0
#     Title: Argus               # Notification title

Example URL username@host:port/TOKEN_A/TOKEN_B/CHANNEL

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: rocketchat
    url_fields:
#     Username: foo
      Host: rocketchat.example.io
#     Port: 443
#     Path: sub/path              # e.g. for rocketchat.example.io/sub/path
      TokenA: TOKEN_A
      TokenB: TOKEN_B
      Channel: CHANNEL

Either a Webhook, or the Slack Bot API can be used.

To get a token for a Bot:

Create an App for your bot with Slacks ‘Creating an app’ guide.
Install the App into your workspace (Slack docs).
From Apps, select your App and go to ‘OAuth & Permissions’
Copy the ‘Bot User OAuth Token’
e.g. `xoxb:012345678901-0123456789012-phq24qfrhqnm2mtmz54dwkop

To use Webhooks:

Create an App for your bot with Slacks ‘Creating an app’ guide.
Enable incoming Webhooks for that app (Slack docs)
Create an incoming Webhook (Slack docs)
e.g. https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
becomes ‘hook:T00000000-B00000000-XXXXXXXXXXXXXXXXXXXXXXXX

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: slack
    url_fields:
      Token: 'xoxb:012345678901-0123456789012-phq24qfrhqnm2mtmz54dwkop'
      Channel: argus
#   params:
#     BotName: Argus                                                     # Bot name
#     Color: ''                                                          # Message left-hand border color
#     Icon: https://release-argus.io/favicons/android-chrome-512x512.png # URL or Emoji to use
#     Title: Release                                                     # Prepended text above the message
#     ThreadTS: ''                                                       # TS value of the parent message (to send message as reply in thread)

Create an ‘Incoming Webhook’ following ‘Microsoft’s docs’.

Example URL https://<organization>.webhook.office.com/webhookb2/<Group>@<Tenant>/IncomingWebhook/<AltId>/<GroupOwner>

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: teams
    url_fields:
      Group: aaaaaaaa-1234-1234-1234-123412341234
      Tenant: bbbbbbbb-1234-1234-1234-123412341234
      AltID: 65f57823a6027db4bb71d156899ea2a6
      GroupOwner: cccccccc-1234-1234-1234-123412341234
      ExtraID: ''
    params:
#     Color: ''
      Host: example.webhook.office.com
#     Title: ''

To get a token, talk to the botfather.
Chats
- @channel-name can only be used for public channels. The name can be found by going to Channel info, just replace the t.me/ prefix with an @.
- chat_id is required for private channels/group chats/private chats. To get the ID, you can forward a message (from the target chat) to @UserInfoBot or @JsonDumpBot and view it at Id and message.forward_from_chat.id from those bots respectively.
- (The above bots are created and hosted by @nadam and their sources are available to view at nadam/userinfobot and nadam/jsondumpbot)

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: telegram
    url_fields:
      Token: TOKEN_FROM_BOTFATHER
    params:
      Chats: '@channel-name,@other-channel,chat_id' # Chat IDs or Channel names (using @channel-name)
#     Notification: yes                             # If disabled, sends the message silently
#     ParseMode: None                               # How the text message should be parsed - None/Markdown/HTML/MarkdownV2
#     Preview: yes                                  # If disabled, no web page preview will be displayed for URLs
#     Title: Argus                                  # Notification title

Zulip Chat

notify:
  ...
  # as many of these (below) as you like, just ensure they have unique ID's.
  EXAMPLE_NOTIFY:
    type: zulip
    url_fields:
      BotMail: bot@release-argus.io
      BotKey: BOT_KEY
      Host: zulip.example.io
#   params:
#     Stream: 'mystream'
#     Topic: 'Argus'

Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.

Last modified December 16, 2025: fix(notify): use disabletls instead of disabletlsverification for ntfy (#109) (7d4c367)