Hybrid

Self-host your Agent Servers and send traces to either a self-hosted LangSmith instance or LangSmith SaaS.

In the hybrid model, you self-host your Agent Servers in your own infrastructure and send traces to LangSmith, where LangSmith can be either a self-hosted instance or LangSmith SaaS.

This gives you control over where your agent workloads run while letting you choose the LangSmith deployment that best fits your observability and compliance requirements.

Components

Component	Where it runs	Who manages it
Agent Servers	Your infrastructure	You
LangSmith (tracing, evaluation, prompts)	Self-hosted in your infrastructure, or LangSmith SaaS	You (self-hosted) or LangChain (SaaS)

Self-host your Agent Servers

Deploy standalone Agent Servers using Docker, Docker Compose, or Kubernetes. See the standalone server guide for prerequisites, environment variables, and platform-specific instructions.

Choose where traces are sent

Agent Servers send traces to LangSmith based on the LANGSMITH_ENDPOINT environment variable:

• LangSmith SaaS: Omit LANGSMITH_ENDPOINT to use the default (GCP US), or set it to the endpoint for your region:

  Region
  GCP US
  GCP EU
  GCP APAC
  AWS US

• Self-hosted LangSmith: Set LANGSMITH_ENDPOINT to the hostname of your self-hosted LangSmith instance.

In both cases, authenticate with a LangSmith API key issued by the LangSmith instance you are tracing to.

---

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.

Edit this page on GitHub or file an issue.