Installation

Prerequisites

• Ignition 8.1.20 or higher
• An Octopush account with API credentials (API Login and API Key)
• Network access to api.octopush.com (HTTPS, port 443)
• For acknowledgment: public accessibility of your Ignition gateway

Download

Download Octopush Module

Installation Steps

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

Verification

After installation:

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

Network Requirements

Outbound (Ignition to Octopush)

The Ignition gateway must be able to reach the Octopush API:

Destination	Protocol	Port
api.octopush.com	HTTPS	443

Inbound (Octopush Webhooks)

For alarm acknowledgment functionality, your Ignition server must accept HTTP POST requests from Octopush servers.

The webhook endpoint is:

https://[IP or domain name]/system/octopush

Firewall Configuration

If your Ignition server is behind a firewall, you need to:

1. Allow inbound HTTPS traffic from Octopush IP ranges
2. Configure port forwarding or a reverse proxy if needed
3. Ensure the callback URL is publicly accessible

Dependencies

The module requires the Alarm Notification module, which is included in all Ignition installations with the Alarming feature.

Troubleshooting

Issue	Solution
Module not appearing	Restart the Ignition gateway and check gateway logs
"Octopush Notification" not in profile types	Verify the Alarm Notification module is running
License warnings	Check trial status in module details