GitOps Promoter

GitOps Promoter is a GitOps-native tool that automates the promotion of application manifests and configuration across your Kubernetes environments.

  • Development
  • Infrastructure
  • Tools & Utilities
GitOps Promoter is a GitOps-native tool that automates the promotion of application manifests and configuration across your Kubernetes environments. It moves changes from one environment to the next through a pull-request-based workflow with per-environment promotion gating, giving you a drift-free, auditable progression path without manual copy-and-paste or fragile automation.

Platform availability

Available on 1 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

60/100 Good

Maintained
100last commit 14 days ago
Popular
58779 GitHub stars
Easy to install
251 install platform, install notes
Light to run
No data
Security check
201 serious finding, CI, tests, OpenSSF Scorecard 8.4/10

Based on 4 of 5 factors.

Availability: platform listings confirmed today

GitHub stars
779
Open issues
150
Last commit
2026-11-07
Latest release
v0.48.0
License
Apache-2.0
Activity
rising

Checked 14 days ago - source: GitHub (argoproj-labs/gitops-promoter)

Resources & Compatibility

Requirements not published yet.

First-install notes

  • Install the promoter with kubectl Run kubectl apply -f https://github.com/argoproj-labs/gitops-promoter/releases/download/v0.6.0/install.yaml (kubectl is the Kubernetes command-line tool) to install the controller, custom resources, permissions, and a webhook service on port 3333 for git-provider events. Without this, your cluster has no promoter components and event updates or promotions cannot work. source
  • Add a PromotionStrategy for each app Create a PromotionStrategy that points to your GitRepository and lists the branches/environments to move code through, with autoMerge (whether a branch merges by itself) set to match how safe each step is. If this is missing or too permissive, the promoter won’t know what to promote or may merge without the review you wanted. source

Fetched 41 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Do I need to manage a separate branch for each environment?

No. You only push to a single branch. Hydrated manifests are automatically managed in environment-specific branches, but you never have to interact with them.

Does it integrate with Git and SCM tooling?

It provides complete integration with git and SCM tooling.

Can promotions be controlled with gates?

It provides a promotion gating system.

Will it make fragile automated changes to user-facing files?

It is designed with no fragile automated changes to user-facing files.

Where can evaluators share feedback?

Open a discussion to share your feedback if you are evaluating it. If you are using it, add yourself to USERS.md.

Answers sourced from github.com, github.com, gitops-promoter.readthedocs.io

Community

Collected 48 days ago - public community threads