Skip to main content
Helm chart
This page is for engineering teams self-hosting their own Lightdash instance. If you want to get started with pre-aggregates, see the pre-aggregates reference.
NATS workers are only recommended for large deployments and should be set up with guidance from the Lightdash team.
NATS moves warehouse query execution off the main Lightdash server and onto dedicated worker pods. This improves responsiveness under load and lets you scale query capacity independently.

Enabling NATS workers

You should be using the Helm chart to deploy Lightdash with NATS workers.
nats:
  enabled: true
warehouseNatsWorker:
  enabled: true

Scaling

warehouseNatsWorker:
  replicas: 2       # more pods = more parallel query capacity
  concurrency: 100  # concurrent jobs per pod
  resources:
    requests:
      memory: 1.5Gi
      cpu: 250m
      ephemeral-storage: 9Gi