woodpecker/docs/docs/30-administration/05-installation/20-helm-chart.md

Helm Chart

Woodpecker provides a Helm chart for Kubernetes environments:

helm install woodpecker oci://ghcr.io/woodpecker-ci/helm/woodpecker --version <VERSION>

Metrics

To enable metrics gathering, set the following in values.yml:

metrics:
  enabled: true
  port: 9001

This activates the /metrics endpoint on port 9001 without authentication. This port is not exposed externally by default. Use the instructions at Prometheus if you want to enable authenticated external access to metrics.

To enable both Prometheus pod monitoring discovery, set:

prometheus:
  podmonitor:
    enabled: true
    interval: 60s
    labels: {}

If you are not receiving metrics after following the steps above, verify that your Prometheus configuration includes your namespace explicitly in the podMonitorNamespaceSelector or that the selectors are disabled:

# Search all available namespaces
podMonitorNamespaceSelector:
  matchLabels: {}
# Enable all available pod monitors
podMonitorSelector:
  matchLabels: {}