Git Pro

Overview

Git Pro embeds a complete Git client directly into the Ignition Designer, enabling professional version control of project resources without leaving the development environment. It provides repository initialization, commit management, branch operations, push/pull/fetch, merge conflict resolution, and commit history browsing — all from within the Designer UI.

Git Pro also versions the gateway's own configuration, separately from any project. A dedicated repository tracks the data directory's config/ folder, commits each change as it happens, and can put the gateway back on any earlier commit live — without a restart and without opening the Designer.

On top of that, Git Pro adds CI/CD deployments on the gateway: connect GitHub, GitLab or Gitea once, pick a repository and branch, and every push to that branch is deployed to the gateway automatically.

Git Pro supersedes the free Git module. It carries the complete open-source core plus the proprietary DevOps add-ons in a single Git-Pro.modl, under the same module id — installing it replaces the free module in place.

Features

Version control in the Designer

• Setup Wizard - Clone from a remote repository (HTTPS or SSH) or initialize a local-only repository directly from the Designer
• Remote Management - Add, edit, and remove named remotes (e.g. origin, upstream), each bound to a saved credential
• User Credentials - Manage user-level SSH keys and per-host HTTPS credentials (with GitHub/GitLab/Azure/Bitbucket hint text), shared across projects and remotes
• Commit Management - Select resources, write commit messages, view diffs before committing, and amend the last commit, from the dockable Commit panel
• Push, Pull & Fetch - Full remote operations with multi-remote support
• Branch Management - List, create, checkout, and delete branches with automatic stash/restore of uncommitted changes
• Merge Conflict Resolution - Dedicated UI with per-file "Accept Ours/Theirs" resolution, a side-by-side conflict diff, and abort/complete-merge actions
• Side-by-Side Diff Viewer - Review changes before committing with color-coded line comparison and synchronized scrolling
• Commit History Browser - Paginated log viewer with ref badges, per-commit file lists, and historical diffs
• Revert & Checkout - Undo specific commits via revert, or inspect past states via detached HEAD checkout
• Gateway Resource Snapshots - Capture tags, themes, and images into the project so they become reviewable, per-file-selectable changes before committing
• Metadata Noise Suppression - Automatically filters out resource.json and thumbnail.png churn when no sibling source file changed, and suppresses JSON key-ordering-only churn
• Dockable Panels - Always-visible Commit and History panels tabbed alongside the Project Browser
• Verified Connections - TLS certificates and SSH host keys are verified, with an explicit per-remote opt-out for self-signed certificates — see Configuration → Connection Security
• Gateway Configuration Versioning - A gateway "config-as-code" page (Platform > System > Versioning) that auto-commits gateway configuration changes to a separate Git repo, lets you restore any commit without a restart, and manually syncs to a remote — see Usage

CI/CD deployments (Pro)

• Provider Connections - Connect GitHub (through a per-gateway GitHub App), GitLab or Gitea (through OAuth) once; self-hosted instances are supported
• Repository & Branch Pickers - Choose what to deploy from a list instead of pasting a clone URL
• No Stored Personal Credentials - Projects are cloned and updated with short-lived provider tokens; no personal access token or SSH key is stored
• Deploy on Push - Push hooks are registered for you; a push to the deployed branch updates the project on the gateway, pushes to other branches are ignored
• Deploy Now - Trigger a deployment manually
• Rename-Safe - Deployments follow the provider's stable repository id, so renaming a repository does not break them

See Usage → CI/CD Deployments.

Technical Specifications

Specification	Value
Module ID	com.operametrix.ignition.git
Module Name	Git Pro
Module File	Git-Pro.modl
Current Version	2.2.0
Minimum Ignition Version	8.3.0
Required Module	None
Scope	Gateway, Designer
Maker Edition	Not supported
License	Proprietary — © 2026 OperaMetrix SAS (paid, with trial). Bundles the open-source Git module core (Beerware) and Eclipse JGit (EDL/BSD).

Ignition 8.3+ only

Git Pro is built for the Ignition 8.3 platform and does not install on 8.1 gateways — use the free 1.x line there. See Installation for upgrade notes.

Licensing

Git Pro is a paid module and participates in Ignition licensing. Without a license it runs in trial mode.

Trial expired behaviour

Only the CI/CD deployments are license-gated. When the trial expires, no deployment runs — not on push, not from Deploy now — and no new CI/CD project can be added. Every other feature, including the Designer workflow and gateway Configuration Versioning, keeps working.

Activating a license resumes deployments immediately, with no gateway restart. Activate a license or reset the trial from Platform > System > Licensing.

Get a Git Pro license

Architecture

The module follows Ignition's multi-scope architecture with Gateway (backend) and Designer (UI) components communicating via RPC:

1. The Gateway scope handles all Git operations using Eclipse JGit 6.10.1 (with Apache MINA sshd for SSH transport) — clone, commit, push, pull, fetch, merge, branch management, diff generation, gateway-resource snapshots, gateway configuration versioning, and CI/CD deployments
2. The Designer scope provides the per-project UI — a status bar, dockable Commit/History panels, and popup dialogs
3. When a user performs an action in the Designer (e.g. commit, push), the request is sent to the Gateway via Ignition's 8.3 module RPC mechanism
4. The Gateway executes the Git operation on the project directory and re-imports the project so changes appear in the Designer
5. Credentials are stored as user-level resources on the Ignition 8.3 resource/config system; remotes reference them by id
6. Results are returned to the Designer, which updates the UI accordingly

Designer UI Components

• Status Bar — Shows the current branch and provides quick-access buttons for Remotes and Git credentials (or a "Configure" button before the repository is set up)
• Dockable Commit Panel — Always-visible panel for at-a-glance uncommitted changes, inline commits, and gateway-resource snapshot buttons
• Dockable History Panel — Always-visible commit log with ref badges and Refresh/Push/Fetch/Pull buttons
• Popups — Init wizard, Diff viewer, Commit detail, Branches, Remotes, User Credentials, and Merge Conflict resolution

Gateway UI Components

• Versioning page (Platform > System > Versioning) — Version-controls the gateway data directory's configuration as code, independent of the per-project Designer workflow
• CI/CD page (Platform > System > CI/CD) — Provider connections and deployments

Download

Download Git Pro

Quick Links

• Installation
• Configuration
• Usage