https://github.com/victoriametrics/helm-charts
Helm charts for VictoriaMetrics, VictoriaLogs and ecosystem
https://github.com/victoriametrics/helm-charts
helm helm-charts kubernetes victoriametrics
Last synced: 5 months ago
JSON representation
Helm charts for VictoriaMetrics, VictoriaLogs and ecosystem
- Host: GitHub
- URL: https://github.com/victoriametrics/helm-charts
- Owner: VictoriaMetrics
- License: apache-2.0
- Created: 2019-10-10T19:20:15.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2025-04-13T07:11:35.000Z (6 months ago)
- Last Synced: 2025-04-14T01:11:23.043Z (6 months ago)
- Topics: helm, helm-charts, kubernetes, victoriametrics
- Language: Smarty
- Homepage: https://victoriametrics.github.io/helm-charts/
- Size: 160 MB
- Stars: 395
- Watchers: 15
- Forks: 355
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
This repository contains helm charts for VictoriaMetrics and VictoriaLogs.
## Add a chart helm repository (can be skipped for OCI repository)
Access a Kubernetes cluster.
Add a chart helm repository with follow commands:
```console
helm repo add vm https://victoriametrics.github.io/helm-charts/
helm repo update
```
List [all charts](#list-of-charts) and versions of `vm` repository available to installation:
```console
helm search repo vm/
```
The command must display existing helm chart e.g.
```shell
NAME CHART VERSION APP VERSION DESCRIPTION
vm/victoria-logs-cluster 0.0.1 v1.20.0 VictoriaLogs cluster version - high-performance...
vm/victoria-logs-single 0.9.7 v1.20.0 Victoria Logs Single version - high-performance...
vm/victoria-metrics-agent 0.19.0 v1.116.0 Victoria Metrics Agent - collects metrics from ...
vm/victoria-metrics-alert 0.18.0 v1.116.0 Victoria Metrics Alert - executes a list of giv...
vm/victoria-metrics-anomaly 1.9.1 v1.22.0-experimental Victoria Metrics Anomaly Detection - a service ...
vm/victoria-metrics-auth 0.13.0 v1.116.0 Victoria Metrics Auth - is a simple auth proxy ...
vm/victoria-metrics-cluster 0.21.0 v1.116.0 Victoria Metrics Cluster version - high-perform...
vm/victoria-metrics-common 0.0.42 Victoria Metrics Common - contains shared templ...
vm/victoria-metrics-distributed 0.14.0 v1.116.0 A Helm chart for Running VMCluster on Multiple ...
vm/victoria-metrics-gateway 0.11.0 v1.116.0 Victoria Metrics Gateway - Auth & Rate-Limittin...
vm/victoria-metrics-k8s-stack 0.45.0 v1.116.0 Kubernetes monitoring on VictoriaMetrics stack....
vm/victoria-metrics-operator 0.45.0 v0.56.0 Victoria Metrics Operator
vm/victoria-metrics-operator-crds 0.1.0 v0.56.0 Victoria Metrics Operator CRDs
vm/victoria-metrics-single 0.18.0 v1.116.0 Victoria Metrics Single version - high-performa...
```
## Installing the chart
Export default values of `victoria-metrics-cluster` chart to file `values.yaml`:
- For HTTPS repository
```console
helm show values vm/victoria-metrics-cluster > values.yaml
```
- For OCI repository
```console
helm show values oci://ghcr.io/victoriametrics/helm-charts/victoria-metrics-agent > values.yaml
```
Change the values according to the need of the environment in ``values.yaml`` file.
Test the installation with command:
- For HTTPS repository
```console
helm install victoria-metrics vm/victoria-metrics-cluster -f values.yaml -n NAMESPACE --debug --dry-run
```
- For OCI repository
```console
helm install victoria-metrics oci://ghcr.io/victoriametrics/helm-charts/victoria-metrics-cluster -f values.yaml -n NAMESPACE --debug --dry-run
```
Install chart with command:
- For HTTPS repository
```console
helm install victoria-metrics vm/victoria-metrics-cluster -f values.yaml -n NAMESPACE
```
- For OCI repository
```console
helm install victoria-metrics oci://ghcr.io/victoriametrics/helm-charts/victoria-metrics-cluster -f values.yaml -n NAMESPACE
```
## Validate installation
Get the pods lists by running these commands:
```console
kubectl get pods -A | grep 'victoria-metrics'
# or list all resources of victoria-metrics
kubectl get all -n NAMESPACE | grep victoria
```
Get the application by running this commands:
```console
helm list -f victoria-metrics -n NAMESPACE
```
See the history of versions of ``victoria-metrics`` application with command.
```console
helm history victoria-metrics -n NAMESPACE
```
## How to uninstall VictoriaMetrics
Remove application with command.
```console
helm uninstall victoria-metrics -n NAMESPACE
```
## Kubernetes compatibility versions
helm charts tested at kubernetes versions from 1.28 to 1.30.
## List of Charts
- [VictoriaLogs Single](https://docs.victoriametrics.com/helm/victorialogs-single)
- [VictoriaLogs Cluster](https://docs.victoriametrics.com/helm/victorialogs-cluster)
- [VictoriaMetrics Agent](https://docs.victoriametrics.com/helm/victoriametrics-agent)
- [VictoriaMetrics Alert](https://docs.victoriametrics.com/helm/victoriametrics-alert)
- [VictoriaMetrics Anomaly](https://docs.victoriametrics.com/helm/victoriametrics-anomaly)
- [VictoriaMetrics Auth](https://docs.victoriametrics.com/helm/victoriametrics-auth)
- [VictoriaMetrics Cluster](https://docs.victoriametrics.com/helm/victoriametrics-cluster)
- [VictoriaMetrics Gateway](https://docs.victoriametrics.com/helm/victoriametrics-gateway)
- [VictoriaMetrics Distributed](https://docs.victoriametrics.com/helm/victoriametrics-distributed)
- [VictoriaMetrics K8s Stack](https://docs.victoriametrics.com/helm/victoriametrics-k8s-stack)
- [VictoriaMetrics Operator](https://docs.victoriametrics.com/helm/victoriametrics-operator)
- [VictoriaMetrics Operator CRDs](https://docs.victoriametrics.com/helm/victoriametrics-operator-crds)
- [VictoriaMetrics Single](https://docs.victoriametrics.com/helm/victoriametrics-single)