Compatibility matrix

Supported technologies and versions for Lago self-hosted deployments.

This document outlines the supported technologies and their versions for Lago self-hosted deployments. Use this matrix to ensure your infrastructure meets the requirements for your target Lago version.

Core dependencies by version

Lago Version	PostgreSQL	Redis	Valkey	Kubernetes	Notes
≥ 1.0	14+	6.2+	7.0+	-	Safe baseline for existing installs
≥ 1.30	15+	7.x	7.2+	-	Recommended for new installs
≥ Latest Release	15+	7.x	7.2+	1.26+	Production-grade setup

For PostgreSQL, the pg_partman extension should be installed on the server.

Check the repository for more details.

Helm chart versions

Two chart lines are published. They are not interchangeable — see Kubernetes for the details.

Chart version	Lago version	Branch	Shape
2.x	v1.41.2+	main	Umbrella chart over independent subcharts
1.x (up to 1.28.0)	up to 1.32.4	v1	Single monolithic chart, maintained for fixes

Analytics and streaming dependencies

These components are required for specific Lago features.

Category	Technology	Supported Version	Purpose
Analytics DB	ClickHouse	25.6+	Required for the ClickHouse event store, analytics, and activity/API/security logs
Streaming	Redpanda	25.2+	Required for event streaming capabilities

Recommendations

For new deployments, we recommend starting with the latest supported versions:

• PostgreSQL 15+ for full compatibility with recent Lago releases
• Redis 7.x or Valkey 7.2+ for optimal performance and stability
• Kubernetes 1.26+ if deploying with Helm charts

PostgreSQL 14 is supported for older Lago versions (≥ 1.0) but newer releases target PostgreSQL 15+. If you are running PostgreSQL 14, plan an upgrade before moving to Lago ≥ 1.30.