Git
This page documents the 1.x line of the Git module, which targets Ignition 8.1. If your gateway is on Ignition 8.3, switch to the 8.3 documentation using the version selector — that release (2.x) is a rebuild for the 8.3 platform and does not install on 8.1.
Overview
The Git module embeds a Git client directly into the Ignition Designer, enabling version control of project resources without leaving the development environment. It eliminates context switching between the Designer and external Git tools by providing repository setup, commit management, branch operations, push/pull/fetch, merge conflict resolution, and commit history browsing — all from within the Designer UI.
Originally created by AXONE-IO (Enzo Sagnelonge) and now maintained by OperaMetrix.
Features
- Setup Wizard — clone from a remote repository (HTTPS or SSH) or initialize a local-only repository directly from the Designer
- Remotes — add, edit, and remove multiple named remotes (e.g.
origin,upstream), each bound to a saved credential - User Credentials — manage SSH keys and per-host HTTPS credentials, shared across all your projects and remotes
- Commit Management — select resources, write commit messages, view diffs before committing, and amend the last commit
- Push, Pull & Fetch — remote operations against your Git host, with a remote selector when multiple remotes exist
- Merge Conflict Resolution — dedicated UI with per-file Accept Ours/Theirs and a side-by-side conflict diff
- Branch Management — list, create, checkout, and delete branches, with automatic stash/restore of uncommitted changes
- Gateway Resource Snapshots — capture tags, Perspective themes, and images into the project so they become reviewable, per-file changes
- Metadata Noise Suppression —
resource.json/thumbnail.png-only churn is hidden when no sibling source file changed - Commit History Browser — paginated log with ref badges, per-commit file lists, and side-by-side historical diffs
- Revert / Checkout any past commit (detached HEAD) from the History panel or commit detail view
Technical Specifications
| Specification | Value |
|---|---|
| Module ID | com.operametrix.ignition.git |
| Module Name | Git |
| Current Version | 1.2.1 |
| Minimum Ignition Version | 8.1.0 |
| Required Module | None |
| Scopes | Gateway (G), Designer (D), Common (DG) |
| License | Beerware (free) |
| Maker Edition | Compatible (free module) |
This release is published as com.operametrix.ignition.git. If you previously ran the AXONE-IO version (com.axone_io.ignition.git), Ignition treats this as a distinct module — you must uninstall the AXONE-IO module before installing this one. See Installation for the migration notes.
On this line, Git credentials are user-level and shared across all of your projects, and the commit author comes from your Ignition user profile rather than a per-project setting. See Configuration.