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 docs for more information.

For Managed LangGraph Platform

If you would like a fast managed environment, consider the Cloud SaaS 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 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 documentation.

Confirm credentials

If you have confirmed that you would like to self-host LangGraph Platform, please verify your credentials.

For Self-Hosted Lite

Confirm that you have provided a working LANGSMITH_API_KEY environment variable in your deployment environment or .env file
Confirm the provided API key is associated with an account on a Plus or Enterprise plan (or equivalent)

For Self-Hosted Enterprise

Confirm that you have provided a working LANGGRAPH_CLOUD_LICENSE_KEY environment variable in your deployment environment or .env file
Confirm the key is still valid and has not surpassed its expiration date

2.4 KiB Raw Blame History