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

# Troubleshoot SmithDB

> Gather troubleshooting context or disable and reset a SmithDB deployment on self-hosted LangSmith.

<Note>
  SmithDB is optional and available in beta. Use this page to gather troubleshooting context or safely disable and reset a SmithDB deployment. Keep ClickHouse configured and available throughout.
</Note>

Use this page to gather troubleshooting context or safely disable and reset a SmithDB deployment.

## Before making changes

* Stop at the current installation or migration stage until the issue is understood.
* Record the LangSmith and Helm chart versions and the most recent configuration change.
* Preserve failed Jobs, TaskDB, and relevant logs before deleting or recreating resources.
* Do not delete the SmithDB metastore or object-storage data while troubleshooting.

## Support

If no documented issue matches, contact LangChain through the [Support Portal](https://support.langchain.com/).

## Disable or reset SmithDB

Use this section to stop routing LangSmith traffic to SmithDB and disable SmithDB services in an existing self-hosted deployment. Keep ClickHouse configured and available throughout.

<Note>
  Return to [Install LangSmith with SmithDB](/langsmith/self-host-smithdb-install) for the installation and cutover sequence.
</Note>

<Warning>
  If a historical migration is active or its progress must be preserved, stop before disabling SmithDB. Disabling migration removes chart-managed TaskDB resources and, by default, its PVC. Contact LangChain through the [Support Portal](https://support.langchain.com/) if you need to preserve migration progress.
</Warning>

### Before you begin

Expect re-enabling SmithDB ingestion later to require another migration to restore consistency with ClickHouse.

### Step 1. Disable SmithDB LangSmith integration

Keep SmithDB services enabled, but disable query, ingestion, and migration:

```yaml theme={null}
smithdb:
  enabled: true
  langsmith:
    ingestion:
      enabled: false
    migration:
      enabled: false
    query:
      enabled: false
```

Apply the chart through your normal deployment workflow and wait for the rollout to complete. This sets LangSmith query and ingestion traffic to solely ClickHouse before any SmithDB workloads are removed.

### Step 2. Disable SmithDB services

After the first Helm update completes, disable SmithDB services while leaving the integration flags off:

```yaml theme={null}
smithdb:
  enabled: false
  langsmith:
    ingestion:
      enabled: false
    migration:
      enabled: false
    query:
      enabled: false
```

Apply the chart again. Separating traffic cutover from workload removal avoids requests racing with SmithDB shutdown.

### Step 3. Optional: remove SmithDB data

<Danger>
  This cleanup is destructive. Continue only after SmithDB services are disabled and its data is no longer needed for re-enablement, diagnosis, or recovery.
</Danger>

Optionally remove the dedicated SmithDB object-storage data and PostgreSQL metastore. Re-enabling SmithDB after this cleanup requires recreating its supporting infrastructure and re-migrating data from ClickHouse.

## See also

* [Enable SmithDB on self-hosted LangSmith](/langsmith/self-host-smithdb)
* [Install LangSmith with SmithDB](/langsmith/self-host-smithdb-install)
* [Prepare SmithDB supporting infrastructure](/langsmith/self-host-smithdb-infrastructure)
* [Configure SmithDB observability](/langsmith/self-host-smithdb-observability)
* [Configure SmithDB for scale](/langsmith/self-host-smithdb-scale)
* [Migrate ClickHouse history to SmithDB](/langsmith/self-host-smithdb-migrate)

***

<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-troubleshooting.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
  </Callout>
</div>