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

# Enable SmithDB on self-hosted LangSmith

> Optionally run SmithDB alongside ClickHouse on an existing self-hosted LangSmith Kubernetes installation.

<Note>
  SmithDB is an optional, opt-in datastore for self-hosted LangSmith. It is available in beta. ClickHouse remains required. You cannot remove ClickHouse after enabling SmithDB. Minimum LangSmith version depends on cloud. See [Check cloud support](#check-cloud-support).
</Note>

SmithDB can serve LangSmith trace ingestion and queries alongside the existing ClickHouse datastore. Enable it on a Kubernetes installation when you want SmithDB-backed query performance while keeping ClickHouse in place.

This section is for existing self-hosted installations. Complete the [Kubernetes setup guide](/langsmith/kubernetes) first. Do not treat SmithDB as part of a new required install path.

## Check cloud support

SmithDB examples in this section cover managed Kubernetes on AWS, GCP, and Azure. They do not cover self-managed clusters.

| Cloud       | SmithDB from                                  |
| ----------- | --------------------------------------------- |
| AWS (EKS)   | LangSmith 0.16, Helm chart `0.16.14` or later |
| GCP (GKE)   | LangSmith 0.16, Helm chart `0.16.14` or later |
| Azure (AKS) | LangSmith 0.17                                |

<CardGroup cols={2}>
  <Card title="Install SmithDB" icon="download" href="/langsmith/self-host-smithdb-install">
    Stage infrastructure, deploy SmithDB services, enable dual ingestion, and switch queries after validation.
  </Card>

  <Card title="Prepare supporting infrastructure" icon="server" href="/langsmith/self-host-smithdb-infrastructure">
    Provide a dedicated PostgreSQL metastore, object storage, and local SSD cache capacity.
  </Card>

  <Card title="Configure for scale" icon="chart-bar" href="/langsmith/self-host-smithdb-scale">
    Choose a tested resource tier and size SmithDB workloads.
  </Card>

  <Card title="Configure observability" icon="activity" href="/langsmith/self-host-smithdb-observability">
    Scrape SmithDB metrics and export logs and traces to your stack.
  </Card>

  <Card title="Migrate historical data" icon="transfer" href="/langsmith/self-host-smithdb-migrate">
    Backfill ClickHouse history into SmithDB before query cutover.
  </Card>

  <Card title="Troubleshoot SmithDB" icon="tool" href="/langsmith/self-host-smithdb-troubleshooting">
    Gather context, disable SmithDB, or reset a deployment safely.
  </Card>
</CardGroup>

## Keep required storage

A self-hosted LangSmith instance still uses ClickHouse for traces and feedback, PostgreSQL for operational data, Redis or Valkey for queuing and caching, and optional blob storage. SmithDB adds its own metastore, object store, and cache nodes. It does not replace those required services in this release.

For SDK method changes that work with both ClickHouse and SmithDB, see [Migrate to SmithDB-backed SDK methods](/langsmith/smithdb-sdk-migration).

## See also

* [Self-hosted LangSmith overview](/langsmith/self-hosted)
* [Self-host LangSmith on Kubernetes](/langsmith/kubernetes)
* [Upgrade a self-hosted LangSmith installation](/langsmith/self-host-upgrades)
* [We built SmithDB, the data layer for agent observability](https://www.langchain.com/blog/introducing-smithdb)
* [Full text search in SmithDB](https://www.langchain.com/blog/full-text-search-in-smithdb-designing-an-inverted-index-for-object-storage)
* [How LangChain built SmithDB inverted index](https://www.langchain.com/blog/full-text-search-in-smithdb-constructing-and-querying-our-inverted-index-pt-2)

***

<div className="source-links">
  <Callout icon="terminal-2">
    [Connect these docs](/use-these-docs) to Claude, VSCode, and more 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-smithdb.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
  </Callout>
</div>