Skip to content

docs(langsmith): add optional SmithDB self-hosted setup guides - #5796

Draft
ben (ben11211) wants to merge 2 commits into
mainfrom
docs/self-host-smithdb
Draft

docs(langsmith): add optional SmithDB self-hosted setup guides#5796
ben (ben11211) wants to merge 2 commits into
mainfrom
docs/self-host-smithdb

Conversation

@ben11211

Copy link
Copy Markdown
Contributor

Summary

  • Add a SmithDB (optional) group under the LangSmith Self-hosted tab with opt-in/beta install, infrastructure, scale, observability, historical migration, and troubleshooting (including disable/reset).
  • Keep ClickHouse as required storage. Do not add SmithDB to the overview storage table. Pointers on the self-hosted overview and Kubernetes install pages are optional next steps only.
  • Defer AlloyDB Auth Proxy and deletion handling as internal. Provider examples cover EKS and GKE only.

Type of change

Type: New documentation page

Related issues/PRs

  • GitHub issue:
  • Feature PR:
  • Linear issue:
  • Slack thread:

Checklist

  • I have read the contributing guidelines, including the language policy
  • I have tested my changes locally using docs dev
  • All code examples have been tested and work correctly
  • I have used root relative paths for internal links
  • I have updated navigation in src/docs.json if needed

(Internal team members only / optional): Create a preview deployment as necessary using the Create Preview Branch workflow

Additional notes

Ported from internal customer-facing SmithDB self-hosted Notion docs. Helm values and commands are copied from that source (placeholders only). Vale (make lint_prose) passed on the changed files.

Local docs dev was not started in this environment because the Mintlify CLI (mint) is not installed and a global install was not applied.

This PR was drafted with AI agent assistance.

Made with Cursor

@github-actions github-actions Bot added langsmith For docs changes to LangSmith internal labels Aug 31, 2026
Publish an opt-in SmithDB section so existing Kubernetes installs can enable SmithDB alongside ClickHouse without treating it as required setup.

Co-authored-by: Cursor <cursoragent@cursor.com>
@ben11211
ben (ben11211) force-pushed the docs/self-host-smithdb branch from c30ae3c to 43a7e1a Compare August 31, 2026 18:52
Document AKS as a 0.17-only path, bump the AWS/GCP Helm floor to 0.16.14, and add Workload Identity plus temporary-disk node-pool examples so Azure operators can follow the same install sequence.

Co-authored-by: Cursor <cursoragent@cursor.com>
@github-actions

Copy link
Copy Markdown
Contributor

Mintlify preview branch generated: preview-docsse-1788217470-b7511b1

Site preview: https://langchain-5e9cc07a-preview-docsse-1788217470-b7511b1.mintlify.site

Important

Preview links may take a few minutes to start working while the deployment finishes.

Changed documentation pages (preview deep links):

Only the top 5 changed markdown files by diff size are listed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

internal langsmith For docs changes to LangSmith

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant