diff --git a/docs/docs/cloud/reference/env_var.md b/docs/docs/cloud/reference/env_var.md index e4d4de0f2..4f21ee890 100644 --- a/docs/docs/cloud/reference/env_var.md +++ b/docs/docs/cloud/reference/env_var.md @@ -1,6 +1,6 @@ # Environment Variables -The LangGraph Cloud Server supports specific environment variables for configuring a deployment. +The LangGraph Server supports specific environment variables for configuring a deployment. ## `BG_JOB_ISOLATED_LOOPS` @@ -32,7 +32,7 @@ See Cloud SaaS(Beta): Connect to your GitHub repositories and deploy LangGraph Servers to LangChain's cloud. We manage everything. +- Self-Hosted Data Plane(Beta): Create deployments from the [Control Plane UI](../concepts/langgraph_control_plane.md#control-plane-ui) and deploy LangGraph Servers to your cloud. We manage the [control plane](../concepts/langgraph_control_plane.md), you manage the deployments. +- Self-Hosted Control Plane(Beta): Create deployments from a self-hosted [Control Plane UI](../concepts/langgraph_control_plane.md#control-plane-ui) and deploy LangGraph Servers to your cloud. You manage everything. - [Standalone Container](../concepts/langgraph_standalone_container.md): Deploy LangGraph Server Docker images however you like. diff --git a/docs/docs/concepts/langgraph_data_plane.md b/docs/docs/concepts/langgraph_data_plane.md index ecb154a10..fa2368387 100644 --- a/docs/docs/concepts/langgraph_data_plane.md +++ b/docs/docs/concepts/langgraph_data_plane.md @@ -58,7 +58,7 @@ In the future, the autoscaling implementation may evolve to accommodate other me ### Static IP Addresses !!! info "Only for Cloud SaaS" - Static IP addresses are only available for [Cloud SaaS](../concepts/langgraph_cloud.md). + Static IP addresses are only available for [Cloud SaaS](../concepts/langgraph_cloud.md) deployments. All traffic from deployments created after January 6th 2025 will come through a NAT gateway. This NAT gateway will have several static IP addresses depending on the data region. Refer to the table below for the list of static IP addresses: @@ -72,3 +72,46 @@ All traffic from deployments created after January 6th 2025 will come through a | 34.169.88.30 | 34.91.238.184 | | 34.19.93.202 | 35.204.101.241 | | 34.19.34.50 | 35.204.48.32 | + +### Custom Postgres + +!!! info "Only for Self-Hosted Data Plane and Self-Hosted Control Plane" + Custom Postgres instances are only available for [Self-Hosted Data Plane](../concepts/langgraph_self_hosted_data_plane.md) and [Self-Hosted Control Plane](../concepts/langgraph_self_hosted_control_plane.md) deployments. + +A custom Postgres instance can be used instead of the [one automatically created by the control plane](./langgraph_control_plane.md#database-provisioning). Specify the [`POSTGRES_URI_CUSTOM`](../cloud/reference/env_var.md#postgres_uri_custom) environment variable to use a custom Postgres instance. + +Multiple deployments can share the same Postgres instance. For example, for `Deployment A`, `POSTGRES_URI_CUSTOM` can be set to `postgres://:@/?host=` and for `Deployment B`, `POSTGRES_URI_CUSTOM` can be set to `postgres://:@/?host=`. `` and `database_name_2` are different databases within the same instance, but `` is shared. **The same database cannot be used for separate deployments**. + +### Custom Redis + +!!! info "Only for Self-Hosted Data Plane and Self-Hosted Control Plane" + Custom Redis instances are only available for [Self-Hosted Data Plane](../concepts/langgraph_self_hosted_data_plane.md) and [Self-Hosted Control Plane](../concepts/langgraph_self_hosted_control_plane.md) deployments. + +A custom Redis instance can be used instead of the one automatically created by the control plane. Specify the [REDIS_URI_CUSTOM](../cloud/reference/env_var.md#redis_uri_custom) environment variable to use a custom Redis instance. + + +Multiple deployments can share the same Redis instance. For example, for `Deployment A`, `REDIS_URI_CUSTOM` can be set to `redis://:/1` and for `Deployment B`, `REDIS_URI_CUSTOM` can be set to `redis://:/2`. `1` and `2` are different database numbers within the same instance, but `` is shared. **The same database number cannot be used for separate deployments**. + +### LangSmith Tracing + +LangGraph Server is automatically configured to send traces to LangSmith. See the table below for details with respect to each deployment option. + +| Cloud SaaS | Self-Hosted Data Plane | Self-Hosted Control Plane | Standalone Container | +|------------|------------------------|---------------------------|----------------------| +| Required

Trace to LangSmith SaaS. | Optional

Disable tracing or trace to LangSmith SaaS. | Optional

Disable tracing or trace to Self-Hosted LangSmith. | Optional

Disable tracing, trace to LangSmith SaaS, or trace to Self-Hosted LangSmith. | + +### Telemetry + +LangGraph Server is automatically configured to report telemetry metadata for billing purposes. See the table below for details with respect to each deployment option. + +| Cloud SaaS | Self-Hosted Data Plane | Self-Hosted Control Plane | Standalone Container | +|------------|------------------------|---------------------------|----------------------| +| Telemetry sent to LangSmith SaaS. | Telemetry sent to LangSmith SaaS. | Self-reported usage (audit) for air-gapped license key.

Telemetry sent to LangSmith SaaS for LangGraph Platform License Key. | Self-reported usage (audit) for air-gapped license key.

Telemetry sent to LangSmith SaaS for LangGraph Platform License Key. | + +### Licensing + +LangGraph Server is automatically configured to perform license key validation. See the table below for details with respect to each deployment option. + +| Cloud SaaS | Self-Hosted Data Plane | Self-Hosted Control Plane | Standalone Container | +|------------|------------------------|---------------------------|----------------------| +| LangSmith API Key validated against LangSmith SaaS. | LangSmith API Key validated against LangSmith SaaS. | Air-gapped license key or LangGraph Platform License Key validated against LangSmith SaaS. | Air-gapped license key or LangGraph Platform License Key validated against LangSmith SaaS. |