Nagios Mobile App

Updated on October 23, 2026 Git Repository Nagios Exchange

Send Nagios host and service alerts to your phone
with Signalgrid as your Nagios mobile app

Nagios is powerful for monitoring, but email alerting is often slow, noisy, and easy to ignore.
Signalgrid gives you a dedicated Nagios mobile app experience, so Nagios host and service alerts arrive instantly on iPhone, Android, and the web.

If you want Nagios alerts on your phone instead of buried in your inbox, this integration gives you a simple way to send mobile alerts when hosts or services change state.


Replace Nagios email alerts with push notifications

Instead of relying on noisy Nagios email alerts, you can send Nagios host alerts and service alerts directly to your phone with push notifications. This makes it easier to notice critical monitoring events quickly and use Signalgrid as your Nagios mobile app for everyday alerting.


Prerequisites

  • curl must be installed to send API requests
  • The script must be executable by the nagios user

Installation

Bash
# Download the latest version git clone https://github.com/signalgridco/signalgrid-nagios.git # Copy the script to /usr/local/bin cp signalgrid-nagios/signalgrid-notify.sh /usr/local/bin/ # Make the script executable chmod +x /usr/local/bin/signalgrid-notify.sh # Edit the script and insert your credentials CLIENT_KEY="[your-client-key]" CHANNEL_TOKEN="[your-channel-token]"

Get your credentials here


Define Notification Commands

Add the following commands to your Nagios configuration:

Bash
define command { command_name notify-service-signalgrid command_line /usr/local/bin/signalgrid-notify.sh "$SERVICEDESC$ on $HOSTNAME$ is $SERVICESTATE$" "$SERVICEOUTPUT$" "$SERVICESTATE$" "false" } define command { command_name notify-host-signalgrid command_line /usr/local/bin/signalgrid-notify.sh "Host $HOSTNAME$ is $HOSTSTATE$" "$HOSTOUTPUT$" "$HOSTSTATE$" "false" }

Assign the Notification Commands

Attach the commands to a contact definition:

Bash
define contact { contact_name signalgrid_user alias Signalgrid User service_notification_commands notify-service-signalgrid host_notification_commands notify-host-signalgrid }

Assign the Contact to a Service

To actually receive alerts, assign that contact to the services that should send notifications:

Bash
define service { use generic-service host_name web01 service_description HTTP check_command check_http contacts signalgrid_user notifications_enabled 1 }

The same approach also works for host definitions. If you prefer using contact groups, assign the matching contact_groups entry instead of contacts.


Script Arguments

The script accepts four positional arguments:

Argument
Description
$1
Title of the notification
$2
Message body or plugin output
$3
State: OK, UP, WARNING, CRITICAL, or DOWN
$4
Critical flag: true or false

Nagios state mapping

Nagios host and service states are automatically mapped to the corresponding Signalgrid notification type to reflect the severity of each alert.

Nagios state
Signalgrid type
OK / UP
SUCCESS
WARNING
WARN
CRITICAL / DOWN
CRIT
Any other state
INFO

Manual Testing

You can verify the integration directly from the command line:

Bash
/usr/local/bin/signalgrid-notify.sh \ "Test Alert" \ "Manual test from terminal" \ "CRITICAL" \ "false"

Related Documentation