The Self-Hosted deployment option allows you to run all components entirely within your own cloud environment. You can choose between two deployment models:
  1. Full Platform: Deploy both control plane and data plane with full UI/API management capabilities
  2. Data Plane Only: Deploy standalone instances of a LangGraph Server without the control plane UI
Important The Self-Hosted deployment options require an Enterprise plan.

Full Platform

Overview

The Full Platform deployment model is a fully self-hosted solution where you manage both the control plane and data plane in your cloud. This option gives you full control and responsibility of the control plane and data plane infrastructure.
Control planeData plane
What is it?
  • Control plane UI for creating deployments and revisions
  • Control plane APIs for creating deployments and revisions
  • Data plane “listener” for reconciling deployments with control plane state
  • LangGraph Servers
  • Postgres, Redis, etc
Where is it hosted?Your cloudYour cloud
Who provisions and manages it?YouYou

Requirements

  • You use langgraph-cli and/or LangGraph Studio app to test graph locally.
  • You use langgraph build command to build image.
  • You have a Self-Hosted LangSmith instance deployed.
  • You are using Ingress for your LangSmith instance. All agents will be deployed as Kubernetes services behind this ingress.

Architecture

Self-Hosted Full Platform Architecture

Compute Platforms

  • Kubernetes: The Full Platform deployment model supports deploying control plane and data plane infrastructure to any Kubernetes cluster.
If you would like to enable this on your LangSmith instance, please follow the Self-Hosted Full Platform deployment guide.

Data Plane Only

Overview

The Data Plane Only deployment model is the least restrictive option for deployment. There is no control plane. Data plane infrastructure is managed by you.
Control planeData plane
What is it?n/a
  • LangGraph Servers
  • Postgres, Redis, etc
Where is it hosted?n/aYour cloud
Who provisions and manages it?n/aYou
LangGraph Platform should not be deployed in serverless environments. Scale to zero may cause task loss and scaling up will not work reliably.

Architecture

Standalone Container

Compute Platforms

Kubernetes

The Data Plane Only deployment model supports deploying data plane infrastructure to a Kubernetes cluster.

Docker

The Data Plane Only deployment model supports deploying data plane infrastructure to any Docker-supported compute platform.
To deploy a LangGraph Server, follow the how-to guide for how to deploy Data Plane Only.