Lakerunner
Installation Guide

Lakerunner Installation Guide

Use the interactive wizard below to generate a configuration for your Lakerunner deployment. Select your installation type and fill in the required details to generate a values.yaml file.

Installation Wizard

🔒 Privacy First: This wizard runs entirely in your browser. No data is sent to any server.

Installation Type

Organization Settings

Lakerunner is multi-tenant. Each tenant is an organization, and the collector and API key are used by that organization.

Click "Generate" to make a random ID, or enter one you have previously used.
Collector name is required and cannot be "default"
This will be used by Grafana and other tools to query telemetry for this organization.

Optional Components

Pre-configured Grafana with Lakerunner datasources
Send Lakerunner telemetry to Cardinal for monitoring. Cardinal will monitor your Lakerunner deployment and provide a dashboard for performance monitoring. We will not see your organization's data, just Lakerunner performance.
This is different from the Lakerunner API key above. Sign up at app.cardinalhq.io and copy your API key from the dashboard.
Work queue-based autoscaling for production workloads

Cloud Provider

Credentials will be provided by EKS via IAM Roles for Service Accounts (IRSA) or EKS Pod Identity. Ensure your cluster and service account are configured appropriately.

PostgreSQL - Lakerunner DB

lakerunner

PostgreSQL - Config DB

lakerunner

Kafka

Generated values.yaml

Please complete all required fields (marked with *) above to generate your values.yaml configuration.

For the complete list of configuration options, see the full values.yaml reference on GitHub (opens in a new tab).

Post-Installation

Verify the Installation

After installation, verify all pods are running:

kubectl get pods -n lakerunner -l app.kubernetes.io/name=lakerunner

Access Grafana

Configure an Ingress or use port-forwarding to access Grafana:

kubectl port-forward -n lakerunner svc/grafana 3000:3000

Upgrading

To upgrade an existing installation:

helm upgrade lakerunner oci://public.ecr.aws/cardinalhq.io/lakerunner \
  --values values.yaml \
  --namespace lakerunner

Uninstalling

To remove Lakerunner:

helm uninstall lakerunner --namespace lakerunner

Note: This does not delete your data in the cloud storage bucket.

Reach out to support@cardinalhq.io for support or to ask questions not answered in our documentation.

OverviewSizing Estimator