Docs4dev
Docs
ansible / latest / collections / community / general / pushover_module.html

community.general.pushover – Send notifications via https://pushover.net

Note

This plugin is part of the community.general collection (version 3.8.1).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.pushover.

Synopsis

  • Send notifications via pushover, to subscriber list of devices, and email addresses. Requires pushover app on devices.

Parameters

Parameter Choices/Defaults Comments
app_token
string / required
Pushover issued token identifying your pushover app.
device
string
added in 1.2.0 of community.general
A device the message should be sent to. Multiple devices can be specified, separated by a comma.
msg
string / required
What message you wish to send.
pri
string
    Choices:
  • -2
  • -1
  • 0 ←
  • 1
  • 2
Message priority (see https://pushover.net for details).
title
string
Message title.
user_key
string / required
Pushover issued authentication key for your user.

Notes

Note

  • You will require a pushover.net account to use this module. But no account is required to receive messages.

Examples

- name: Send notifications via pushover.net
  community.general.pushover:
    msg: '{{ inventory_hostname }} is acting strange ...'
    app_token: wxfdksl
    user_key: baa5fe97f2c5ab3ca8f0bb59
  delegate_to: localhost

- name: Send notifications via pushover.net
  community.general.pushover:
    title: 'Alert!'
    msg: '{{ inventory_hostname }} has exploded in flames, It is now time to panic'
    pri: 1
    app_token: wxfdksl
    user_key: baa5fe97f2c5ab3ca8f0bb59
  delegate_to: localhost

- name: Send notifications via pushover.net to a specific device
  community.general.pushover:
    msg: '{{ inventory_hostname }} has been lost somewhere'
    app_token: wxfdksl
    user_key: baa5fe97f2c5ab3ca8f0bb59
    device: admins-iPhone
  delegate_to: localhost

Authors

  • Jim Richardson (@weaselkeeper)
  • Bernd Arnold (@wopfel)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/pushover_module.html