Pinpoint Helm Chart

January 30, 2026 · View on GitHub

A Helm chart for deploying Pinpoint APM on Kubernetes.

Introduction

This chart bootstraps a Pinpoint APM deployment on a Kubernetes cluster using the Helm package manager.

To install the chart with the release name pinpoint:

git clone https://github.com/pinpoint-apm/pinpoint-kubernetes.git
cd pinpoint-kubernetes
helm dependency update

This chart supports two deployment modes:

Metric Profile (default):

helm install pinpoint . -n pinpoint --create-namespace

Deploys Kafka, Pinot, and Telegraf for advanced metrics collection.

Classic Mode:

helm install pinpoint . -n pinpoint --create-namespace --set global.metric.enabled=false

Deploys Batch and Flink modules for traditional APM processing.

Note: You may see warnings about SessionAffinity is ignored for headless services. These are harmless warnings and do not affect functionality.

Name	Description	Value
`global.metric.enabled`	Enable metric profile deployment	`true`
`global.pinpointVersion`	Pinpoint version	`"3.0.3"`
`global.image.pullPolicy`	Image pull policy	`IfNotPresent`
`global.datasource.enabled`	Enable global datasource configuration - `true` (default): Injects datasource env vars. Defaults to the bundled MySQL if `mysql.enabled` is true. - `false`: No datasource env vars are injected into Web/Batch.	`true`
`global.datasource.driverClassName`	JDBC driver class name - Defaults to the MySQL driver from the chart dependency	`""`
`global.datasource.jdbcUrl`	JDBC URL for external database - Defaults to the MySQL service from the chart dependency	`""`
`global.datasource.username`	Database username - Defaults to the MySQL username from the chart dependency	`""`
`global.datasource.passwordSecret.name`	Secret name containing password	`""`
`global.datasource.passwordSecret.key`	Key in the Secret containing the password	`""`
`global.datasource.password`	Database password (Not RECOMMENDED for production) - Defaults to the MySQL password from the chart dependency	`""`

After installation, you can access the Pinpoint services:

Web UI:

kubectl port-forward svc/pinpoint-web 8080:8080 -n pinpoint

Then open http://localhost:8080 in your browser.

Pinot Controller UI (Real-time Data Management):

kubectl port-forward svc/pinpoint-pinot-controller 9000:9000 -n pinpoint

Then open http://localhost:9000 in your browser.

To uninstall the pinpoint deployment:

helm uninstall pinpoint -n pinpoint