# renovatebot/helm-charts architecture

> Architecture diagram of the GitHub repository renovatebot/helm-charts, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/renovatebot/helm-charts
- Repository: https://github.com/renovatebot/helm-charts

## Overview

This repository packages Renovate as a Kubernetes Helm chart; it is not Renovate’s update engine. The documented workflow is for an operator to install the chart and supply a valid self-hosted Renovate configuration. The chart includes templates for the scheduled workload and supporting Kubernetes resources. Those template roles are inferred from the file tree; no source excerpts were provided to verify their wiring or runtime behavior.

Main entry points: [`charts/renovate/Chart.yaml`](https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/Chart.yaml) (Renovate chart), [`charts/renovate/templates/config.yaml`](https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/config.yaml) (Renovate config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deployment["Chart deployment"]
  node_renovate_chart["Renovate chart<br/>[Chart.yaml]"]
  node_chart_values["Chart values<br/>[values.yaml]"]
  node_renovate_config["Renovate config<br/>[config.yaml]"]
end

subgraph group_resources["Kubernetes resources"]
  node_scheduled_workload["Scheduled workload<br/>[cronjob.yaml]"]
  node_credentials["Credentials<br/>[secret.yaml]"]
  node_ssh_credentials["SSH credentials<br/>[ssh-secret.yaml]"]
  node_persistent_storage[("Persistent storage<br/>[pvc.yaml]")]
  node_service_account["Service account"]
  node_extra_config["Extra config map"]
  node_extra_manifests["Extra manifests"]
end

node_operator(("Operator"))
node_kubernetes["Kubernetes"]

node_operator -->|"installs chart"| node_renovate_chart
node_operator -->|"supplies config"| node_renovate_config

click node_renovate_chart "https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/Chart.yaml"
click node_chart_values "https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/values.yaml"
click node_renovate_config "https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/config.yaml"
click node_scheduled_workload "https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/cronjob.yaml"
click node_credentials "https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/secret.yaml"
click node_ssh_credentials "https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/ssh-secret.yaml"
click node_persistent_storage "https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/pvc.yaml"
click node_service_account "https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/serviceaccount.yaml"
click node_extra_config "https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/extra-configmap.yaml"
click node_extra_manifests "https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/extra-manifests.yaml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_renovate_chart,node_chart_values,node_renovate_config toneBlue
class node_scheduled_workload,node_credentials,node_ssh_credentials,node_persistent_storage,node_service_account,node_extra_config,node_extra_manifests toneAmber
class node_operator,node_kubernetes toneIndigo
```

## Components

### Chart deployment

- [Renovate chart](https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/Chart.yaml): `charts/renovate/Chart.yaml`
- [Chart values](https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/values.yaml): `charts/renovate/values.yaml`
- [Renovate config](https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/config.yaml): `charts/renovate/templates/config.yaml`

### Kubernetes resources

- [Scheduled workload](https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/cronjob.yaml): `charts/renovate/templates/cronjob.yaml`
- [Credentials](https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/secret.yaml): `charts/renovate/templates/secret.yaml`
- [SSH credentials](https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/ssh-secret.yaml): `charts/renovate/templates/ssh-secret.yaml`
- [Persistent storage](https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/pvc.yaml): `charts/renovate/templates/pvc.yaml`
- [Service account](https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/serviceaccount.yaml): `charts/renovate/templates/serviceaccount.yaml`
- [Extra config map](https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/extra-configmap.yaml): `charts/renovate/templates/extra-configmap.yaml`
- [Extra manifests](https://github.com/renovatebot/helm-charts/blob/main/charts/renovate/templates/extra-manifests.yaml): `charts/renovate/templates/extra-manifests.yaml`

### Other components

- **Operator**
- **Kubernetes**

## Connections

- Operator → Renovate chart: installs chart (evidence: `README.md`)
- Operator → Renovate config: supplies config (evidence: `README.md`)
