Home / Integration plugins / LibreNMS SMS Integration

+

Send SMS alerts from LibreNMS

LibreNMS alerts reach the person on duty as an SMS. SMSEagle sends them over its own cellular connection, so they don’t depend on internet access or a cloud service.

Native SMSEagle support in LibreNMS

LibreNMS supports SMSEagle natively. Select SMSEagle as the notification method, enter the device address and login details, and alerts start arriving by SMS.

Works with the alert rules you already have

LibreNMS sends an SMS whenever one of your alert rules fires, for example when a device goes down.

Works without internet

SMSEagle sends alerts through its own SIM card straight to the mobile network, so they don’t depend on internet access or a cloud SMS provider.

How it works

1

Event Trigger

A LibreNMS alert rule matches a monitored condition, for example a device going down.

2

Communication

LibreNMS’s built-in Smseagle alert transport sends an HTTP API request to the SMSEagle device over your local network.

3

Alert

SMSEagle delivers the alert over its own cellular connection, not through a third-party service, as an SMS to the recipient’s phone.

Set up in about 10 minutes

Create a user with API access in SMSEagle, add a Smseagle alert transport in LibreNMS, and you’re done.

SMSEagle sends LibreNMS alerts to the right person by SMS, day and night.

No per-message fees

SMSEagle sends SMS through a regular SIM card, so you only pay for your mobile plan.

Alerts keep going if one carrier fails

On devices with two SIM cards from different operators, SMSEagle switches to the second one when the first operator’s network is down.

Alerts keep working even if one device fails

Two SMSEagle devices can work as an HA cluster: if one fails, the other takes over sending.

SMSEagle configuration

  1. Create a new user in SMSEagle (menu System > Users) with access level “User”.
  2. Grant API access to the created user:
    • go to Settings > Global settings > API and open the API v1 page
    • click Create API key, fill in Key name and select that user as Owner
    • Add access permissions in section Permissions for: Send SMS, Send to contact, Send to group
    • click Create key. Then, in System > Users, open that user and tick Enable user/password authentication (APIv1 only).
  3. Open Settings > Global settings > Network > SSL, turn off Forward HTTP to HTTPS and click Save changes.

LibreNMS configuration

I. Setup new Alert Transport method

2. Click on Create alert transport button

  • Set Transport name to your name e.g SMS
  • Set Transport type to: Smseagle

Fill the fields below:

  • SMSEagle Base URL: with http(s)://SMSEagle_IP
  • user: with username you created in Step: SMSEagle Setup.
  • password: with password you created in Step: SMSEagle Setup.
  • mobiles: numbers which you would like to receive SMS alerts, can be new line or comma separated

Save Transport settings

II. Test

In the list of all transports, click on the Test transport button next to your new SMS notification to initiate a test SMS.
You should receive an SMS text message on the number you just entered.

III. Add SMS Notification to Alert Rules

1. In the LibreNMS web interface, open Alerts > Alert Rules

2.Edit existing rules or create a new one

  • Select previously created SMS transport from dropdown menu
  • Save rule settings

You should now receive SMS notifications according to your rules setup.

Explore SMSEagle Demo device

SMSEagle is a hardware & software solution that guarantees a swift delivery of your messages to designated recipients, whether it’s for notifications, alerts, or important updates.

After registering to a demo you get a remote access to our physical device NXS-9750.

  • 14-days free trial
  • Access to over 20 functionalities

What is hardware
SMS Gateway?

Learn more about
SMSEagle features