Skip to content

Installing Perses with Helm#

This guide covers how to install Perses on Kubernetes using Helm charts.

Prerequisites#

Helm must be installed to use the charts. Please refer to Helm's documentation to get started.

Installation#

Add the Perses Helm Repository#

Add the Perses Helm repository and update your local repository cache:

helm repo add perses https://perses.github.io/helm-charts
helm repo update

Basic Installation#

Install Perses with default configuration:

helm install my-perses perses/perses # my-perses is the release name

Using FluxCD#

If you want to use Perses with FluxCD, you can include the Perses manifests directly in your GitOps repository so Flux can reconcile and deploy them automatically.

apiVersion: source.toolkit.fluxcd.io/v1
kind: HelmRepository
metadata:
  name: perses
  namespace: <namespace>
spec:
  interval: 12h
  url: https://perses.github.io/helm-charts
---
apiVersion: helm.toolkit.fluxcd.io/v2
kind: HelmRelease
metadata:
  name: perses
  namespace: <namespace>
spec:
  interval: 1h
  timeout: 5m
  releaseName: perses
  targetNamespace: <namespace>
  chart:
    spec:
      chart: perses
      version: <version>
      sourceRef:
        kind: HelmRepository
        name: perses
        namespace: <namespace>
      interval: 1m

  install:
    createNamespace: true
    remediation:
      retries: 3

  upgrade:
    remediation:
      retries: 3

Verification#

After installation, verify that Perses is running:

# Check pod status
kubectl get pods -l app.kubernetes.io/name=my-perses

# Check service
kubectl get svc -l app.kubernetes.io/name=my-perses

# View logs
kubectl logs -l app.kubernetes.io/name=my-perses

If you configured an ingress, you should be able to access Perses at your configured hostname. Otherwise, you can port-forward to access the service:

kubectl port-forward svc/my-perses 8080:80

Then visit http://localhost:8080 in your browser to access the Perses UI.