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. |
| 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
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.
