Update license key troubleshooting (#3157)

docs/docs/concepts/deployment_options.md

@@ -51,7 +51,7 @@ For more information, please see:
 
     The LangGraph Platform Deployments view (within LangSmith SaaS and self-hosted LangSmith) is not available for Self-Hosted Lite LangGraph deployments. Self-hosted LangGraph deployments are managed externally from LangSmith (e.g. there is no UI to manage these deployments).
 
-The Self-Hosted Lite deployment option is a free (up to 1 million nodes executed), limited version of LangGraph Platform that you can run locally or in a self-hosted manner.
+The Self-Hosted Lite deployment option is a free (up to 1 million nodes executed per year), limited version of LangGraph Platform that you can run locally or in a self-hosted manner.
 
 With a Self-Hosted Lite deployment, you are responsible for managing the infrastructure, including setting up and maintaining required databases and Redis instances.
 

docs/docs/concepts/index.md

@@ -72,7 +72,7 @@ The LangGraph Platform comprises several components that work together to suppor
 ### Deployment Options
 
 
-- [Self-Hosted Lite](./self_hosted.md): A free (up to 1 million nodes executed), limited version of LangGraph Platform that you can run locally or in a self-hosted manner
+- [Self-Hosted Lite](./self_hosted.md): A free (up to 1 million nodes executed per year), limited version of LangGraph Platform that you can run locally or in a self-hosted manner
 - [Cloud SaaS](./langgraph_cloud.md): Hosted as part of LangSmith.
 - [Bring Your Own Cloud](./bring_your_own_cloud.md): We manage the infrastructure, so you don't have to, but the infrastructure all runs within your cloud.
 - [Self-Hosted Enterprise](./self_hosted.md): Completely managed by you.

docs/docs/concepts/self_hosted.md

@@ -11,7 +11,7 @@ There are two versions of the self-hosted deployment: [Self-Hosted Enterprise](.
 
 ### Self-Hosted Lite
 
-The Self-Hosted Lite version is a limited version of LangGraph Platform that you can run locally or in a self-hosted manner (up to 1 million nodes executed).
+The Self-Hosted Lite version is a limited version of LangGraph Platform that you can run locally or in a self-hosted manner (up to 1 million nodes executed per year).
 
 When using the Self-Hosted Lite version, you authenticate with a [LangSmith](https://smith.langchain.com/) API key.
 

docs/docs/how-tos/index.md

@@ -303,3 +303,9 @@ These are the guides for resolving common errors you may find while building wit
 - [INVALID_GRAPH_NODE_RETURN_VALUE](../troubleshooting/errors/INVALID_GRAPH_NODE_RETURN_VALUE.md)
 - [MULTIPLE_SUBGRAPHS](../troubleshooting/errors/MULTIPLE_SUBGRAPHS.md)
 - [INVALID_CHAT_HISTORY](../troubleshooting/errors/INVALID_CHAT_HISTORY.md)
+
+### LangGraph Platform Troubleshooting
+
+These guides provide troubleshooting information for errors that are specific to the LangGraph Platform.
+
+- [INVALID_LICENSE](../troubleshooting/errors/INVALID_LICENSE.md)

docs/docs/troubleshooting/errors/INVALID_LICENSE.md

@@ -0,0 +1,48 @@
+# INVALID_LICENSE
+
+This error is raised when license verification fails while attempting to start a self-hosted LangGraph Platform server. This error is specific to the LangGraph Platform and is not related to the open source libraries.
+
+## When This Occurs
+
+This error occurs when running a self-hosted deployment of LangGraph Platform without a valid enterprise license or API key.
+
+## Troubleshooting
+
+### Confirm deployment type
+
+First, confirm the desired mode of deployment.
+
+#### For Local Development
+
+If you're just developing locally, you can use the lightweight in-memory server by running `langgraph dev`.
+See the [local server](../how-tos/local-server.md) docs for more information.
+
+#### For Managed LangGraph Platform
+
+If you would like a fast managed environment, consider the [Cloud SaaS](../langgraph_cloud.md) deployment option. This requires no additional license key.
+
+#### For Self-Hosted Lite (Limited Features)
+
+If your deployment is unlikely to see more than 1 million node executions per year and don't need Crons and other enterprise features, consider the [Self-Hosted Lite](../deployment_options.md#self-hosted-lite) deployment option.
+
+You can deploy with Self-Hosted Lite by setting a valid `LANGSMITH_API_KEY` in your environment (e.g., in the `.env` file referenced by `langgraph.json`) and building a Docker image. The API key must be associated with an account on a **Plus** plan or greater.
+
+#### For Self-Hosted Enterprise (Full Features)
+
+For full self-hosting, set the `LANGGRAPH_CLOUD_LICENSE_KEY` environment variable. If you are interested in an enterprise license key, please contact the LangChain support team.
+
+For more information on deployment options and their features, see the [Deployment Options](../../concepts/deployment_options.md) documentation.
+
+### Confirm credentials
+
+If you have confirmed that you would like to self-host LangGraph Platform, please verify your credentials.
+
+#### For Self-Hosted Lite
+
+1. Confirm that you have provided a working `LANGSMITH_API_KEY` environment variable in your deployment environment or `.env` file
+2. Confirm the provided API key is associated with an account on a **Plus** or **Enterprise** plan (or equivalent)
+
+#### For Self-Hosted Enterprise
+
+1. Confirm that you have provided a working `LANGGRAPH_CLOUD_LICENSE_KEY` environment variable in your deployment environment or `.env` file
+2. Confirm the key is still valid and has not surpassed its expiration date

docs/docs/troubleshooting/errors/index.md

@@ -1,6 +1,6 @@
 # Error reference
 
-This page contains guides around resolving common errors you may find while building with LangChain.
+This page contains guides around resolving common errors you may find while building with LangGraph.
 Errors referenced below will have an `lc_error_code` property corresponding to one of the below codes when they are thrown in code.
 
 - [GRAPH_RECURSION_LIMIT](./GRAPH_RECURSION_LIMIT.md)
@@ -8,3 +8,9 @@ Errors referenced below will have an `lc_error_code` property corresponding to o
 - [INVALID_GRAPH_NODE_RETURN_VALUE](./INVALID_GRAPH_NODE_RETURN_VALUE.md)
 - [MULTIPLE_SUBGRAPHS](./MULTIPLE_SUBGRAPHS.md)
 - [INVALID_CHAT_HISTORY](./INVALID_CHAT_HISTORY.md)
+
+## LangGraph Platform
+
+These guides provide troubleshooting information for errors that are specific to the LangGraph Platform.
+
+- [INVALID_LICENSE](./INVALID_LICENSE.md)

docs/docs/tutorials/deployment.md

@@ -12,7 +12,7 @@ Get started deploying your LangGraph applications locally or on the cloud with
 
 ## Deployment Options
 
-- [Self-Hosted Lite](../concepts/self_hosted.md): A free (up to 1 million nodes executed), limited version of LangGraph Platform that you can run locally or in a self-hosted manner
+- [Self-Hosted Lite](../concepts/self_hosted.md): A free (up to 1 million nodes executed per year), limited version of LangGraph Platform that you can run locally or in a self-hosted manner
 - [Cloud SaaS](../concepts/langgraph_cloud.md): Hosted as part of LangSmith.
 - [Bring Your Own Cloud](../concepts/bring_your_own_cloud.md): We manage the infrastructure, so you don't have to, but the infrastructure all runs within your cloud.
 - [Self-Hosted Enterprise](../concepts/self_hosted.md): Completely managed by you.

docs/mkdocs.yml

@@ -362,6 +362,7 @@ nav:
           - troubleshooting/errors/INVALID_GRAPH_NODE_RETURN_VALUE.md
           - troubleshooting/errors/MULTIPLE_SUBGRAPHS.md
           - troubleshooting/errors/INVALID_CHAT_HISTORY.md
+          - troubleshooting/errors/INVALID_LICENSE.md
       - LangGraph Academy Course: https://academy.langchain.com/courses/intro-to-langgraph
   
   - API reference: