Installation

Prerequisites

• Ignition 8.3.0 or higher
• The Alarm Notification module (com.inductiveautomation.alarm-notification) installed and running — hard dependency; the module faults without it
• A Teltonika cellular router with an active, SMS-capable SIM card
• Network reachability from the Ignition gateway to the router over HTTP

API-Mode-Specific Requirements

Mode	Requirements
REST (default)	Firmware exposing the RUTOS REST API — /api/login, /api/messages/actions/send, /api/modems/status, and /api/sms_gateway/... for forwarding auto-configuration — plus an API user permitted to POST sends and read modem status.
Legacy	Older firmware exposing /cgi-bin/sms_send.

Router Preparation

Before installing the module, ensure your Teltonika router is properly configured:

1. Verify SIM Card - Ensure the SIM is active and SMS-capable.
2. Note the Host - Record the router's IP address (or hostname). If it does not listen on the default port, note the port too — it must be embedded in the Host field (e.g. 192.168.1.1:80).
3. Create an API User (REST mode) - Create a user with permission to POST sends and read modem status.
4. (Optional) Identify the Modem - For REST mode you may specify a modem name (e.g. 1-1), but this is optional: leave it blank to let the module auto-detect the router's primary modem.

Two-Way Messaging (Optional)

If you plan to use SMS-reply acknowledgement, the router must be able to reach the gateway's inbound servlet at:

http://<gateway-host>:8088/system/teltonika

The port is simply the gateway's own web port — 8088 is the Ignition default, so use whatever yours listens on. An HTTPS callback URL works too (point it at the gateway's TLS port and set Auto-configure Forwarding Verify Certificate accordingly). Note this applies only to the router → gateway direction: the module's own requests to the router are always plain HTTP.

In REST mode the module can configure the router's SMS→HTTP forwarding rule automatically (see Configuration). Otherwise, configure it manually on the router.

Download

Download Teltonika Module

Installation Steps

1. Log in to your Ignition Gateway web interface.
2. Navigate to Platform > System > Modules.
3. Click Install or Upgrade a Module.
4. Select the Teltonika-Alarm-Notification.modl file.
5. Review and accept the license agreement.
6. The module installs and registers the Teltonika Notification profile type with the Alarm Notification system.

Verification

After installation:

1. Verify the module appears in the modules list with Running status.
2. Navigate to Services > Alarming > Notification.
3. Click Create new Alarm Notification Profile...
4. Verify that Teltonika Notification appears as an available profile type.

Upgrading from Ignition 8.1

The notification profile must be re-created. There is no automatic importer: the 8.1 build stored profile settings as a PersistentRecord row in the gateway's internal database, and the 8.3 build stores them as a config resource. The 8.1 row is left in place and ignored.

Write down your router Host, Username, and Modem (if set) before upgrading, then create a fresh Teltonika Notification profile at Services > Alarming > Notification.

Schema changes

8.1	8.3
Host, Username, Modem, Legacy	Unchanged
Password — plain text field	Secret field — encrypted at rest, and can reference a Secret Provider entry
AuditProfileId — numeric reference	auditProfileName — referenced by name
—	twoWayMessaging, callbackToken, ignitionCallbackUrl, verifyCallbackCert — new (see Two-Way Messaging)

"Legacy" is not about the upgrade

The Legacy checkbox selects the older /cgi-bin/sms_send router API instead of the RUTOS REST API. It has nothing to do with migrating from 8.1 — keep whatever the 8.1 profile used.

Network Requirements

Gateway to Router

All requests to the router are plain HTTP; the port is embedded in the Host field.

Direction	Destination	Protocol	Notes
Gateway → Router	Router Host	HTTP	Port embedded in Host (e.g. 192.168.1.1:80)

Router to Gateway (Two-Way Messaging only)

Direction	Destination	Protocol	Notes
Router → Gateway	http://<gateway-host>:8088/system/teltonika	HTTP or HTTPS	Required only when Two-Way Messaging is enabled. 8088 is the Ignition default web port — use your gateway's.

Firewall Configuration

If the router is on a different network segment, ensure firewall rules allow HTTP traffic from the gateway to the router — and, for two-way messaging, from the router back to the gateway.

Troubleshooting

Issue	Solution
Module faults / not running	Confirm the Alarm Notification module is installed and running; check the gateway logs.
"Teltonika Notification" not in profile types	Verify the Alarm Notification module is running.
Cannot connect to router	Verify the Host (including embedded port) and network connectivity over HTTP.
Authentication failed (REST)	Verify the API user's username/password and permissions.
SMS not sending	Check SIM status and signal strength on the router; review the profile's health status.