Minimum versions for self-hosting dependencies

This page lists the minimum supported versions for the databases, tools, and infrastructure used by self-hosted LangSmith. Install a version that meets or exceeds the minimum before deploying or upgrading. Using a version below the minimum is not supported and may cause installation or runtime failures.

If you are using a managed service (such as Amazon RDS, Google Cloud SQL, or Azure Database), pick a version at or above the minimum listed here. Refer to the linked “External services” pages for connection and authentication details.

Datastores

Dependency	Minimum version	Notes
PostgreSQL	14	Primary relational store for operational data. Required for both LangSmith and standalone Agent Server deployments. Used to install the `btree_gin`, `btree_gist`, `pgcrypto`, `citext`, `ltree`, and `pg_trgm` extensions.
Redis	6.2	Used for queueing and caching. Standalone and Redis Cluster modes are both supported. As of Agent Server 0.8.0, the Redis-backed run queue requires Redis 6.2 or later: it enqueues runs with the `ZADD ... LT` flag, which was added in 6.2.
Valkey	8	Officially supported as a drop-in replacement for Redis. Standalone and Cluster modes are both supported.
ClickHouse	Version specified in the LangSmith Helm chart or greater	Stores traces and feedback. ClickHouse 24.2 or later requires LangSmith v0.6 or later. Downgrades are not supported.

Redis < 6.2 and PostgreSQL < 14 are not supported. A LangSmith installation pointed at an older Redis or PostgreSQL instance may fail to start or behave unpredictably. Upgrade your datastore before installing or upgrading LangSmith.

Compute and orchestration

Dependency	Minimum version	Notes
Kubernetes	Any version supported by the upstream Kubernetes release cycle	LangSmith is regularly tested on GKE, EKS, AKS, Minikube, and Kind.
OpenShift	4.14	Supported as a Kubernetes distribution for LangSmith.
Helm	3	Used to install and upgrade the LangSmith Helm chart.
Docker	A version compatible with Docker Compose v2	Required for Docker-based standalone Agent Server deployments.

LangSmith chart and platform

Dependency	Minimum version	Notes
LangSmith Helm chart	Latest stable release	We recommend pinning to the latest stable chart release. Refer to the self-hosted changelog for per-release upgrade notes.
Egress to `https://beacon.langchain.com`	LangSmith 0.9.0 or later	Required for license verification and usage reporting unless running in offline mode.

Where these versions are enforced

PostgreSQL 14 or later: refer to Connect to an external PostgreSQL database.
Redis 6.2 or later and Valkey 8: refer to Connect to an external Redis or Valkey database.
ClickHouse: use the version specified in the LangSmith Helm chart or greater: refer to Connect to an external ClickHouse database.
Kubernetes cluster prerequisites: refer to Self-host LangSmith on Kubernetes.

If you are unsure which version is currently running, contact your database administrator or refer to your cloud provider’s console. If you need to upgrade a dependency before upgrading LangSmith, refer to your vendor’s documentation.

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.

Edit this page on GitHub or file an issue.

Get started by cloud provider

Deploy with Terraform

Setup guides

Configuration

Connect external services

Platform auth & access control

Self-hosted observability

Hybrid

Scripts

Reference

Minimum versions for self-hosting dependencies

Datastores

Compute and orchestration

LangSmith chart and platform

Where these versions are enforced

​Datastores

​Compute and orchestration

​LangSmith chart and platform

​Where these versions are enforced

Datastores

Compute and orchestration

LangSmith chart and platform

Where these versions are enforced