LangSmithOnboarding

Hybrid Onboarding Overview

Understand what LangSmith Hybrid involves and what your team needs to prepare for data plane setup.

Relevant Tools
Admin Readiness Review→RBAC & SCIM Guide→ABAC Policy Builder→Cluster Sizing Calculator→
Onboarding Partner Your assigned Customer Engineer and Solution Architect team own your onboarding experience. The SA team will guide you through the data plane installation.

What is LangSmith Hybrid?

LangSmith Hybrid splits infrastructure between LangChain's cloud and your own environment:

  • Control Plane — Managed by LangChain. Hosts the LangSmith UI, deployment management APIs, and observability data storage. You access this exactly like LangSmith Cloud.
  • Data Plane — Managed by you. Runs in your Kubernetes cluster and consists of the listener application, LangGraph Server instances, and their backing stores (Redis, Postgres).

This model gives you LangChain's fully-managed observability platform while keeping agent workloads inside your own infrastructure — useful for data residency requirements or workloads that cannot leave your environment.

Onboarding Overview

Phase 1: Cloud-Side Account Setup

Hybrid starts with the same Cloud-side setup as LangSmith Cloud:

  1. Sign up at https://smith.langchain.com (US) or https://eu.smith.langchain.com (EU) using your company email.
  2. Create your organization — do not use the personal org created on first login. See set up hierarchy.
  3. Share your Organization ID with your Customer Engineer — they need this to configure your org for Hybrid on the LangChain side.

Phase 2: Data Plane Installation

Your Solution Architect will guide you through the data plane setup. Here is what the installation involves so your team can prepare:

What you need:

  • A Kubernetes cluster meeting minimum requirements
  • A container registry accessible by your cluster (for pulling LangGraph Server images)
  • An Ingress controller installed on your cluster
  • Network egress from your cluster to two LangChain control plane URLs:
    • https://api.host.langchain.com
    • https://api.smith.langchain.com

What gets installed:

The langgraph-dataplane Helm chart deploys three components into your cluster:

  • Listener — polls the LangSmith control plane for new deployment instructions
  • Operator — creates and manages LangGraph Server pods in your cluster
  • Redis — backing store for the data plane (or connect your own)

The full installation guide lives in the official Hybrid deployment docs. Your SA will work through this with you directly.

Next: Configure Your Organization

With your Cloud account and data plane set up, use the Admin Readiness Review to work through all org configuration — SSO, SCIM, workspace design, roles, ABAC policy, API keys, data retention, Fleet setup, and more. Your Customer Engineer will guide you through each topic.