https://github.com/mogenius/renovate-operator
Operator to streamline renovate executions in Kubernetes
https://github.com/mogenius/renovate-operator
cloud-native golang helm-chart kubernetes kubernetes-operator renovate self-hosted
Last synced: 2 months ago
JSON representation
Operator to streamline renovate executions in Kubernetes
- Host: GitHub
- URL: https://github.com/mogenius/renovate-operator
- Owner: mogenius
- License: mit
- Created: 2025-09-10T10:34:47.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-04-02T13:14:24.000Z (3 months ago)
- Last Synced: 2026-04-02T21:31:05.533Z (3 months ago)
- Topics: cloud-native, golang, helm-chart, kubernetes, kubernetes-operator, renovate, self-hosted
- Language: Go
- Homepage:
- Size: 1.58 MB
- Stars: 317
- Watchers: 0
- Forks: 27
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
[](https://artifacthub.io/packages/helm/mogenius/renovate-operator)
[](https://github.com/mogenius/renovate-operator/actions/workflows/release.yaml)
---
# Renovate: The Kubernetes-Native Way
Run [Renovate][1] on your own infrastructure with CRD-based scheduling, parallel execution, auto-discovery, and a built-in UI. If you self-host Renovate and already run Kubernetes, this operator gives you the control and observability that plain self-hosted setups lack.
**Supports all Renovate platforms:** GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, and more. The operator works with any [platform supported by Renovate][4] - simply configure your credentials and platform settings via environment variables or secrets. Note that some platforms have additional operator-specific features like native webhook integrations for GitHub and GitLab.
### Comparison with Mend Renovate CE
| Feature | [Mend Renovate CLI][3]| [Mend Renovate Community Self-Hosted (aka "CE")][2] | Renovate Operator |
|:---|:---:|:---:|:---:|
| Fully open source, no signup or license key | ✅ | ❌ | ✅ |
| Automated dependency updates | ✅ | ✅ | ✅ |
| Runs on your own infrastructure | ✅ | ✅ | ✅ |
| Auto-discovery | ✅ | ✅ | ✅ |
| Webhook API for on-demand runs | ❌ | ✅ | ✅ |
| Web UI | ❌ | ❌ | ✅ |
| Declarative cron scheduling via CRD | ❌ | ❌ | ✅ |
| Auto-discovery with group/topic filtering | ❌ | ❌ | ✅ |
| Per-project status tracking in-cluster | ❌ | ❌ | ✅ |
| Parallel execution with concurrency control | ❌ | ❌ | ✅ |
| Prometheus metrics & health checks | ❌ | ✅ | ✅ |
| Kubernetes-native pod scheduling | ❌ | ❌ | ✅ |
| Leader election for high availability | ❌ | ❌ | ✅ |
| Job lifecycle management (TTL, deadlines, retries) | ❌ | ❌ | ✅ |
### How it works
1. At the defined time of your schedule, a renovate discovery job is started
2. After the discovery finished, you will be able to see all your discovered projects in the UI
3. All projects are now being set to be scheduled
4. Every 10 seconds the operator checks for schedules projects and starts a new renovate job
5. Only as many jobs as defined in `spec.parallelism` are getting executed at the same time
## Installation
### Helm
#### Option 1: OCI Registry
```sh
helm -n renovate-operator upgrade --install renovate-operator \
oci://ghcr.io/mogenius/helm-charts/renovate-operator \
--create-namespace --wait
```
#### Option 2: Helm Repository
```sh
helm repo add mogenius https://helm.mogenius.com/public --force-update
helm -n renovate-operator upgrade --install renovate-operator mogenius/renovate-operator --create-namespace --wait
```
## Documentation
- **Platform Setup**
- [GitLab](./docs/platforms/gitlab.md)
- [GitHub PAT](./docs/platforms/github-pat.md)
- [GitHub App - External Secrets Operator](./docs/platforms/github-app-eso.md)
- Native GitHub App Support - We are still working on that
- _Azure DevOps, Bitbucket, Gitea, Forgejo, and others: configure via `extraEnv`_ ([see Renovate platform docs](./docs/platforms/generic.md))
- [Autodiscovery](./docs/autodiscovery.md)
- Webhook API
- [Generic](./docs/webhooks/webhook.md)
- [Forgejo](./docs/webhooks/forgejo.md)
- [GitHub](./docs/webhooks/github.md)
- [GitLab](./docs/webhooks/gitlab.md)
- [Using a config.js](./docs/extra-volumes.md)
- [Image Pull Secrets](./docs/image-pull-secrets.md)
- [Scheduling](./docs/scheduling.md)
- [Metrics](./docs/metrics.md)
- [PR Activity](./docs/pr-activity.md)
- [Authentication](./docs/auth.md)
## Contributing
Made with [contrib.rocks](https://contrib.rocks).
## Development
**Running the operator**
Needs `KUBECONFIG` variable exported with the path to your local kube-config and a context you want to use.
```sh
just run
```
**Running Tests**
Run the test-suite using just:
```sh
just test-unit
```
Run golangci-lint using just:
```sh
just golangci-lint
```
Run all checks (tests + linters):
```sh
just check
```
**Generate CRDs**
```sh
just generate
```
[1]: https://github.com/renovatebot/renovate
[2]: https://docs.mend.io/renovate/latest/
[3]: https://docs.renovatebot.com/
[4]: https://docs.renovatebot.com/modules/platform/