Skip to content

Countly

Deploy Countly on Kubernetes — a product analytics platform with event tracking, crash reporting, push notifications, A/B testing, and 41+ plugins.

Key Features

  • Full analytics stack — event tracking, crash reporting, push notifications, A/B testing
  • MongoDB backend — bundled subchart or external connection
  • Dual ports — separate API (3001) and Dashboard (6001) endpoints
  • Plugin system — configurable plugin list for feature selection
  • Scalable workers — configurable API worker processes
  • Ingress support — TLS via cert-manager with configurable ingress class

Installation

HTTPS repository:

helm repo add helmforge https://repo.helmforge.dev
helm repo update
helm install countly helmforge/countly -f values.yaml

OCI registry:

helm install countly oci://ghcr.io/helmforgedev/helm/countly -f values.yaml

Basic Example

countly:
  apiWorkers: 4

mongodb:
  enabled: true

ingress:
  enabled: true
  ingressClassName: traefik
  hosts:
    - host: countly.example.com
      paths:
        - path: /
          pathType: Prefix

External MongoDB

mongodb:
  enabled: false

externalMongodb:
  enabled: true
  uri: 'mongodb://user:[email protected]:27017/countly'

Key Values

KeyDefaultDescription
countly.apiPort3001API port
countly.dashboardPort6001Dashboard port
countly.apiWorkers4API worker processes
countly.plugins""Plugins to enable (comma-separated)
mongodb.enabledtrueEnable bundled MongoDB
externalMongodb.enabledfalseUse external MongoDB
externalMongodb.uri""External MongoDB URI
service.port80Dashboard service port
service.apiPort3001API service port

Operational Notes

  • MongoDB only — no PostgreSQL support
  • single instance per MongoDB database
  • dashboard and API run in the same container on separate ports

More Information

See the source code and full values reference on GitHub.