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.Documentation Index
Fetch the complete documentation index at: https://docs.langchain.com/llms.txt
Use this file to discover all available pages before exploring further.
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. |
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
>= 5and Valkey8: 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.
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.