Skip to main content

Installation

Prerequisites​

  • Ignition 8.1.0 or higher
  • Network access to your Git remote repository (GitHub, GitLab, Bitbucket, etc.)
  • For SSH authentication: an SSH key pair

Download​

Download Git 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 Git.modl file
  5. Review and accept the license agreement
  6. The module installs automatically and creates its database schema
Upgrading from AXONE-IO Version

If you previously had the AXONE-IO version of this module installed (com.axone_io.ignition.git), you must uninstall it first before installing this version (com.operametrix.ignition.git), as Ignition treats them as separate modules.

Verification​

After installation:

  1. Verify the module appears in the modules list with Running status
  2. Navigate to Config > Git to verify the configuration pages are available
  3. Open the Ignition Designer and verify the Git toolbar and status bar appear
First Launch

When opening a project in the Designer for the first time, the status bar will show "Not configured". Click on it to launch the repository initialization wizard.

Network Requirements​

Outbound (Ignition to Git Remote)​

The Ignition gateway must be able to reach your Git remote repository:

ProtocolPortDescription
HTTPS443For HTTPS-based Git remotes (GitHub, GitLab, Bitbucket, etc.)
SSH22For SSH-based Git remotes
Firewall Configuration

Ensure outbound access from the Ignition gateway to your Git hosting provider. No inbound connections are required — all Git operations are initiated by the gateway.

Dependencies​

The Git module has no dependencies on other Ignition modules. It works with any Ignition installation running version 8.1.0 or higher.

Troubleshooting​

IssueSolution
Module not appearingRestart the Ignition gateway and check gateway logs
Git toolbar not visible in DesignerEnsure the project is registered — click the status bar to run the setup wizard
Conflict with AXONE-IO moduleUninstall the old com.axone_io.ignition.git module before installing
SSH connection failureVerify the SSH key format and that port 22 is open to your Git host
HTTPS authentication failureVerify username and password/token — many providers require personal access tokens instead of passwords