GitOps Promoter
GitOps Promoter is a GitOps-native tool that automates the promotion of application manifests and configuration across your Kubernetes environments.
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.
Security check: 1 serious finding
- A private key is committed in the source code (RENOVATE_SETUP.md:74)
Automated checks on commit 28039be, 29 Oct 2026. Not an audit.
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
Variants
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
- GitOps testing and promotion procedures and practices (reddit)
- Homelabbers looking to step into GitOps... : r/selfhosted - Reddit (reddit)
Collected 48 days ago - public community threads