> ## Documentation Index
> Fetch the complete documentation index at: https://langchain-5e9cc07a-preview-change-1791323909-75c753a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

## Datastores

| Dependency | Minimum version | Notes |
| - | - | - |
| [PostgreSQL](/langsmith/self-host-external-postgres) | 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](/langsmith/self-host-external-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](/langsmith/self-host-external-redis) | 8 | Officially supported as a drop-in replacement for Redis. Standalone and Cluster modes are both supported. |
| [ClickHouse](/langsmith/self-host-external-clickhouse) | Version specified in the [LangSmith Helm chart](https://github.com/langchain-ai/helm/releases) or greater | Stores traces and feedback. ClickHouse 24.2 or later requires LangSmith v0.6 or later. Downgrades are not supported. |

<Warning>
  **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.
</Warning>

## Compute and orchestration

| Dependency | Minimum version | Notes |
| - | - | - |
| [Kubernetes](/langsmith/kubernetes) | Any version supported by the [upstream Kubernetes release cycle](https://kubernetes.io/releases/) | LangSmith is regularly tested on GKE, EKS, AKS, Minikube, and Kind. |
| [OpenShift](/langsmith/kubernetes) | 4.14 | Supported as a Kubernetes distribution for LangSmith. |
| [Helm](https://helm.sh/docs/intro/install/) | 3 | Used to install and upgrade the LangSmith Helm chart. |
| Docker | A version compatible with [Docker Compose v2](https://docs.docker.com/compose/) | Required for Docker-based standalone Agent Server deployments. |

## LangSmith chart and platform

| Dependency | Minimum version | Notes |
| - | - | - |
| [LangSmith Helm chart](https://github.com/langchain-ai/helm/releases) | Latest stable release | We recommend pinning to the latest stable chart release. Refer to the [self-hosted changelog](/langsmith/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](/langsmith/self-host-egress). |

## Where these versions are enforced

* PostgreSQL 14 or later: refer to [Connect to an external PostgreSQL database](/langsmith/self-host-external-postgres#requirements).
* Redis 6.2 or later and Valkey 8: refer to [Connect to an external Redis or Valkey database](/langsmith/self-host-external-redis#requirements).
* ClickHouse: use the version specified in the [LangSmith Helm chart](https://github.com/langchain-ai/helm/releases) or greater: refer to [Connect to an external ClickHouse database](/langsmith/self-host-external-clickhouse#requirements).
* Kubernetes cluster prerequisites: refer to [Self-host LangSmith on Kubernetes](/langsmith/kubernetes#prerequisites).

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.

***

<div className="source-links">
  <Callout icon="terminal-2">
    [Connect these docs](/use-these-docs) to your agent of choice via MCP for real-time answers.
  </Callout>

  <Callout icon="edit">
    [Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/langsmith/self-host-dependency-versions.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
  </Callout>
</div>