Skip to main content
Lightdash is open-source, so you can deploy and operate your own instance instead of using Lightdash Cloud. This covers your install paths — Docker Compose, Kubernetes/Helm, or an on-prem enterprise setup — plus the production deployment checklist for running it at scale. You’ll also find how to upgrade between versions and how to customize your deployment: SSO, SMTP, external storage, logging, and other environment configuration.

Self-Host Lightdash

Lightdash Cloud vs. Self-Hosted

Lightdash is open-source and licensed under the MIT license. This means that you are free to self-host Lightdash on your own infrastructure but without any warranty or support from the Lightdash team.

Self-host Lightdash using docker compose

Production deployment checklist

Best practices for running an enterprise-grade self-hosted Lightdash deployment with the official Helm chart.

Upgrading Lightdash

How Lightdash versioning works and how to upgrade a self-hosted deployment safely, including the migration job and rollback.

Enterprise on-prem setup

Guide for deploying Lightdash Enterprise Edition on-prem, on prem, on premises, on-premises on your own infrastructure. FedRAMP ready.

NATS workers

Warehouse workers

Configure and scale dedicated warehouse query worker pods.

Pre-aggregate workers

Configure and scale pre-aggregate worker pods for materialization and DuckDB query serving.

Customize deployment

Enterprise License Keys

Access enterprise features on self-hosted Lightdash instances

Configure MCP for self-hosted Lightdash

Enable the Model Context Protocol (MCP) integration on your self-hosted Lightdash instance.

Configure a Slack integration for self-hosted Lightdash

Configure a Github integration for self-hosted Lightdash

Configure Lightdash to use an external database

Configure Lightdash to use external storage

Configure logging for Lightdash

Configure Prometheus metrics for self-hosted Lightdash

Configure SMTP for Lightdash email notifications

Run a dedicated scheduler worker

Add headless browser on self-hosting

We use a chrome headless browser to generate images from your charts and dashboards so we can send them via email or Slack.

Environment variables

Configure a Google Sheets integration for self-hosted Lightdash

In this guide we will show you how you can [upload to Google Sheets in scheduled deliveries](/integrations/sync-google-sheets) and upload results from `charts` to Google Sheets on your self-hosted Lightdash server.

Resource recommendations

Recommended resource requests and availability settings for each Lightdash component.

Sandboxes

How Lightdash runs LLM-generated code safely in isolated sandboxes, and how to configure the sandbox provider on a self-hosted instance.

Secure Lightdash with HTTPS

To run Lightdash in production it is highly recommended to secure it with HTTPS. This is usually done using your cloud provider's load balancer or ingress controller. Optionally you could use a proxy service like [nginx](https://www.nginx.com/) or [traefik](https://traefik.io).

Configure Lightdash to use passwords or SSO for authentication