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. This will be the initial organization ID, and should not change after use. If you wish to have Cardinal monitor your deployment, sign up on app.cardinalhq.io and use the organization ID from that site.
Collector name is required and cannot be "default"

Optional Components

Pre-configured Grafana with Lakerunner datasources
Deploys an OTel Collector for ingesting telemetry data
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

Send Test Data

The OpenTelemetry Collector endpoint is available for ingesting telemetry. Use port-forwarding to send test data:

kubectl port-forward -n lakerunner svc/collector 4318:4318
 
# Then send test data
curl -X POST http://localhost:4318/v1/logs \
  -H "Content-Type: application/json" \
  -d '{"resourceLogs":[{"resource":{},"scopeLogs":[{"scope":{},"logRecords":[{"body":{"stringValue":"test log"}}]}]}]}'

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.

OverviewLakerunner vs. Loki