Minimum versions for self-hosting dependencies

Minimum supported versions for the databases, tools, and infrastructure required to self-host LangSmith.

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	5	Used for queueing and caching. Standalone and Redis Cluster modes are both supported.
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 versions >= 24.2 require LangSmith v0.6 or later. Downgrades are not supported.

Redis < 5 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: refer to Connect to an external PostgreSQL database.
• Redis >= 5 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.