Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/langsmith/components.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ sidebarTitle: Overview
mode: wide
---

When running the self-hosted [LangSmith with deployment](/langsmith/deploy-self-hosted-full-platform), your installation includes several key components. Together these tools and services provide a complete solution for building, deploying, and managing graphs (including agentic applications) in your own infrastructure:
When running self-hosted [LangSmith Deployment](/langsmith/deploy-self-hosted-full-platform), your installation includes several key components. Together these tools and services provide a complete solution for building, deploying, and managing graphs (including agentic applications) in your own infrastructure:

```mermaid
flowchart
Expand Down
16 changes: 9 additions & 7 deletions src/langsmith/deploy-self-hosted-full-platform.mdx
Original file line number Diff line number Diff line change
@@ -1,25 +1,27 @@
---
title: Self-host LangSmith with deployment
sidebarTitle: With deployment
title: Enable LangSmith Deployment
sidebarTitle: Enable deployment
icon: "server"
---

This guide shows you how to enable **deployment management** on your self-hosted LangSmith instance. This adds a [control plane](/langsmith/control-plane) and [data plane](/langsmith/data-plane) that let you deploy, scale, and manage agents and applications directly through the LangSmith UI.
This guide shows you how to enable **LangSmith Deployment** on your [self-hosted LangSmith instance](/langsmith/kubernetes). This adds a [control plane](/langsmith/control-plane) and [data plane](/langsmith/data-plane) that let you deploy, scale, and manage agents and applications directly through the LangSmith UI.

<Info>**Important**<br></br> Self-hosting LangSmith with deployment requires an [Enterprise](https://langchain.com/pricing) plan. </Info>
After completing this guide, you'll have access to LangSmith [Observability](/langsmith/observability), [Evaluation](/langsmith/evaluation), and [Deployment](/langsmith/deployments).

<Info>**Important**<br></br> Enabling LangSmith Deployment requires an [Enterprise](https://langchain.com/pricing) plan. </Info>

<Note>
**This setup page is for adding [deployment](/langsmith/deployments) capabilities to an existing LangSmith instance.**
**This setup page is for enabling [LangSmith Deployment](/langsmith/deployments) on an existing LangSmith instance.**

Review the [self-hosted options](/langsmith/self-hosted) to understand:
- [LangSmith (observability)](/langsmith/self-hosted#langsmith): What you should install first.
- [LangSmith with deployment](/langsmith/self-hosted#langsmith-with-deployment): What this guide enables.
- [LangSmith Deployment](/langsmith/self-hosted#langsmith-deployment): What this guide enables.
- [Standalone Server](/langsmith/self-hosted#standalone-server): Lightweight alternative without the UI.
</Note>

## Overview

This guide builds on top of the [Kubernetes installation guide](/langsmith/kubernetes). **You must complete that guide first** before continuing. This page covers the additional setup steps required to enable deployment functionality:
This guide builds on top of the [Kubernetes installation guide](/langsmith/kubernetes). **You must complete that guide first** before continuing. This page covers the additional setup steps required to enable LangSmith Deployment:
- Installing the LangGraph operator
- Configuring your ingress
- Connecting to the control plane
Expand Down
4 changes: 2 additions & 2 deletions src/langsmith/deploy-standalone-server.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ This guide shows you how to deploy **standalone <Tooltip tip="The server that ru

This deployment option provides flexibility but requires you to manage your own infrastructure and configuration. Each environment can vary significantly and, as a result, troubleshooting configuration issues may be challenging.

For production workloads, we recommend [LangSmith with deployment](/langsmith/self-hosted#langsmith-with-deployment), which offers standardized deployment patterns and more comprehensive support options.
For production workloads, we recommend [LangSmith Deployment](/langsmith/self-hosted#langsmith-deployment), which offers standardized deployment patterns and more comprehensive support options.
</Warning>

<Note>
Expand All @@ -20,7 +20,7 @@ For production workloads, we recommend [LangSmith with deployment](/langsmith/se
Review the [self-hosted options](/langsmith/self-hosted) to understand:
- [Standalone Server](/langsmith/self-hosted#standalone-server): What this guide covers (no UI, just servers).
- [LangSmith](/langsmith/self-hosted#langsmith): For the full LangSmith platform with UI.
- [LangSmith with deployment](/langsmith/self-hosted#langsmith-with-deployment): For UI-based deployment management.
- [LangSmith Deployment](/langsmith/self-hosted#langsmith-deployment): For UI-based deployment management.

Before continuing, review the [standalone server overview](/langsmith/self-hosted#standalone-server).
</Note>
Expand Down
6 changes: 3 additions & 3 deletions src/langsmith/deploy-with-control-plane.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ This guide shows you how to deploy your applications to [hybrid](/langsmith/hybr

Before using this guide, you must have already completed infrastructure setup:
- **[Hybrid setup](/langsmith/deploy-hybrid)**: For hybrid hosting.
- **[Self-hosted with deployment setup](/langsmith/deploy-self-hosted-full-platform)**: For self-hosted with control plane.
- **[Enable LangSmith Deployment](/langsmith/deploy-self-hosted-full-platform)**: For self-hosted with control plane.

If you haven't set up your infrastructure yet, start with the [Hosting section](/langsmith/hosting).
</Note>
Expand All @@ -31,8 +31,8 @@ Before completing this guide, you'll need the following:

- Completed infrastructure setup to enable your [data plane](/langsmith/data-plane) to receive application deployments:
- [Hybrid setup](/langsmith/deploy-hybrid): Installs data plane components (listener, operator, CRDs) in your Kubernetes cluster that connect to LangChain's managed control plane.
- [Self-hosted with deployment setup](/langsmith/deploy-self-hosted-full-platform): Enables deployment management on your self-hosted LangSmith instance.
- Access to the [LangSmith UI](https://smith.langchain.com) with deployment management enabled.
- [Enable LangSmith Deployment](/langsmith/deploy-self-hosted-full-platform): Enables LangSmith Deployment on your self-hosted LangSmith instance.
- Access to the [LangSmith UI](https://smith.langchain.com) with LangSmith Deployment enabled.
- A container registry accessible by your Kubernetes cluster.

## Step 1. Test locally
Expand Down
6 changes: 3 additions & 3 deletions src/langsmith/hosting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ sidebarTitle: Hosting LangSmith
mode: wide
---

This section covers how to host and manage LangSmith infrastructure. You have the flexibility of setting up LangSmith for [observability](/langsmith/observability), [evaluation](/langsmith/evaluation), and [prompt engineering](/langsmith/prompt-engineering) features or using the full platform that also includes optional [LangSmith Deployment](/langsmith/deployments) features for deploying your applications through the UI.
This section covers how to host and manage LangSmith infrastructure. You can set up LangSmith for [observability](/langsmith/observability), [evaluation](/langsmith/evaluation), and [prompt engineering](/langsmith/prompt-engineering), or use the full platform experience with [LangSmith Deployment](/langsmith/deployments) to also deploy and manage your applications through the UI.

<Callout icon="building" color="#2563EB" iconType="regular">
**Start here if you're setting up or maintaining LangSmith infrastructure.**
Expand Down Expand Up @@ -46,7 +46,7 @@ You'll deploy LangSmith in one of three modes:
href="/langsmith/self-hosted"
cta="Run self-hosted"
>
**(Enterprise)** Full control with observability, evaluation, and prompt engineering. Optionally add application deployment or run standalone servers.
**(Enterprise)** Full control with observability, evaluation, and prompt engineering. Enable the full platform experience with LangSmith Deployment or run standalone servers.
</Card>
</Columns>

Expand All @@ -59,7 +59,7 @@ Refer to the following table for a comparison of hosting options:
| **Infrastructure location** | LangChain's cloud | Split: Control plane in LangChain cloud, data plane in your cloud | Your cloud |
| **Who manages updates** | LangChain | LangChain (control plane), You (data plane) | You |
| **Who manages CI/CD for your apps** | LangChain | You | You |
| **Can deploy applications?** | ✅ Yes | ✅ Yes | ✅ Yes (with full platform option) |
| **Can deploy applications?** | ✅ Yes | ✅ Yes | ✅ Yes (with LangSmith Deployment) |
| **Observability data location** | LangChain cloud | LangChain cloud | Your cloud |
| **[Pricing](https://www.langchain.com/plans)** | Plus tier | Enterprise | Enterprise |
| **Best for** | Quick setup, managed infrastructure | Data residency requirements + managed control plane | Full control, data isolation |
Expand Down
29 changes: 13 additions & 16 deletions src/langsmith/kubernetes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,29 +7,26 @@ sidebarTitle: Install on Kubernetes
Self-hosting LangSmith is an add-on to the Enterprise Plan designed for our largest, most security-conscious customers. See our [pricing page](https://www.langchain.com/pricing) for more detail, and [contact our sales team](https://www.langchain.com/contact-sales) if you want to get a license key to trial LangSmith in your environment.
</Info>

This page describes how to set up the **LangSmith** (observability, tracing, and evaluation) in a Kubernetes cluster. You'll use Helm to install LangSmith and its dependencies.

<Note>
This guide installs the base [LangSmith platform](/langsmith/self-hosted#langsmith) which includes observability and evaluation, but **not** the deployment management features. Review the [self-hosted options](/langsmith/self-hosted) if you're unsure which you need.
</Note>
This page describes how to set up **LangSmith** (observability, tracing, and evaluation) in a Kubernetes cluster. You'll use Helm to install LangSmith and its dependencies.

After completing this page, you'll have:

- ✅ **LangSmith UI and APIs**: for observability, tracing, and evaluation.
- ✅ **Backend services**: (queue, playground, ACE).
- ✅ **Datastores**: (PostgreSQL, Redis, ClickHouse, optional blob storage).
- ❌ **Deployment management**: To add deployment capabilities, complete this guide first, then follow [Self-host LangSmith with deployment](/langsmith/deploy-self-hosted-full-platform).
- **LangSmith UI and APIs**: for [observability](/langsmith/observability), tracing, and [evaluation](/langsmith/evaluation).
- **Backend services**: (queue, playground, ACE).
- **Datastores**: (PostgreSQL, Redis, ClickHouse, optional blob storage).

For [agent deployment](/langsmith/deployments): To add deployment capabilities, complete this guide first, then follow [Enable LangSmith Deployment](/langsmith/deploy-self-hosted-full-platform).

We've successfully tested LangSmith on the following Kubernetes distributions:
LangChain has successfully tested LangSmith on the following Kubernetes distributions:

* Google Kubernetes Engine (GKE)
* Amazon Elastic Kubernetes Service (EKS)
* Azure Kubernetes Service (AKS)
* OpenShift (4.14+)
* Minikube and Kind (for development purposes)
- Google Kubernetes Engine (GKE)
- Amazon Elastic Kubernetes Service (EKS)
- Azure Kubernetes Service (AKS)
- OpenShift (4.14+)
- Minikube and Kind (for development purposes)

<Note>
We have several Terraform modules the help in the provisioning of resources for LangSmith. You can find those in our [public Terraform repo](https://github.com/langchain-ai/terraform).
LangChain has several Terraform modules the help in the provisioning of resources for LangSmith. You can find those in the LangChain [public Terraform repo](https://github.com/langchain-ai/terraform).

Supported cloud providers include:

Expand Down
Loading