Skip to content

chore: update standalone docs #3582

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hari-dhanushkodi merged 1 commit into from
Apr 14, 2026
+9 −18
Merged

chore: update standalone docs #3582

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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/docs.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -734,8 +734,8 @@
"group": "Deployment guides",
"pages": [
"langsmith/deploy-to-cloud",
"langsmith/deploy-with-control-plane",
"langsmith/deploy-standalone-server",
"langsmith/deploy-with-control-plane",
"langsmith/diagnostics-self-hosted"
]
},
Expand Down
25 changes: 8 additions & 17 deletions src/langsmith/deploy-standalone-server.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,23 +5,10 @@ icon: "server"
description: Deploy standalone Agent Servers using Docker, Docker Compose, or Kubernetes without the LangSmith control plane.
---

This guide shows you how to deploy **standalone <Tooltip tip="The server that runs your LangGraph applications.">Agent Servers</Tooltip>** without the LangSmith UI or control plane. This is the most lightweight self-hosting option for running one or a few agents as independent services.

<Warning>
This deployment option provides flexibility but requires you to manage your own infrastructure and configuration.

For production workloads, consider [self-hosting the full LangSmith platform](/langsmith/self-hosted) or [deploying with the control plane](/langsmith/deploy-with-control-plane), which offer standardized deployment patterns and UI-based management.
</Warning>
This guide shows you how to deploy **standalone <Tooltip tip="The server that runs your LangGraph applications.">Agent Servers</Tooltip>** directly, without using the [LangSmith control plane](/langsmith/deploy-with-control-plane). You can deploy the server independently and still use LangSmith separately for tracing and evaluation. Standalone servers are production-ready and provide the most lightweight self-hosting option for running agents.

<Note>
**This is the setup page for deploying Agent Servers directly without the LangSmith platform.**

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 Deployment](/langsmith/self-hosted#enable-langsmith-deployment): For UI-based deployment management.

Before continuing, review the [standalone server overview](/langsmith/self-hosted#standalone-server).
For an overview of self-hosted deployment options, see [self-hosted options](/langsmith/self-hosted).
</Note>

## Prerequisites
Expand Down Expand Up @@ -54,12 +41,14 @@ Before continuing, review the [standalone server overview](/langsmith/self-hoste
<a id="helm"></a>
## Kubernetes

Use this [Helm chart](https://github.com/langchain-ai/helm/blob/main/charts/langgraph-cloud/README.md) to deploy an Agent Server to a Kubernetes cluster.
Use this [Helm chart](https://github.com/langchain-ai/helm/blob/main/charts/langgraph-cloud/README.md) to deploy an Agent Server to a Kubernetes cluster. This is the recommended setup for production standalone server deployments.

The Helm chart (v0.2.6+) supports MongoDB checkpointing with a bundled instance (dev/testing) or an external deployment (production). Set `mongo.enabled: true` in your values file. See [Configure checkpointer backend](/langsmith/configure-checkpointer#deploy-by-environment) for full configuration details.

## Docker

This `docker` example is intended for local development and testing.

Run the following `docker` command:

```shell
Expand All @@ -82,7 +71,9 @@ and you should provide appropriate values for `REDIS_URI`, `DATABASE_URI`, and `

## Docker Compose

Docker Compose YAML file:
This Docker Compose example is intended for local development and testing.

Use the following Docker Compose file:

```yml
volumes:
Expand Down
Loading