Skip to main content
This is the comprehensive setup and management guide for deploying applications to LangSmith Cloud.
Looking for a quick setup? Try the quickstart guide first.
Before setting up, review the Cloud overview page to understand the Cloud hosting model.

​
Prerequisites

  1. LangSmith applications are deployed from GitHub repositories. Configure and upload a LangSmith application to a GitHub repository in order to deploy it to LangSmith.
  2. Verify that the LangGraph API runs locally. If the API does not run successfully (i.e. langgraph dev), deploying to LangSmith will fail as well.

​
Create new deployment

Starting from the LangSmith UI:
  1. In the left-hand navigation panel, select Deployments, which contains a list of existing deployments.
  2. In the top-right corner, select + New Deployment to create a new deployment.
  3. In the Create New Deployment panel, fill out the required fields.
  4. Deployment details
  5. Select Import from GitHub and follow the GitHub OAuth workflow to install and authorize LangChain’s hosted-langserve GitHub app to access the selected repositories. After installation is complete, return to the Create New Deployment panel and select the GitHub repository to deploy from the dropdown menu. Note: The GitHub user installing LangChain’s hosted-langserve GitHub app must be an owner of the organization or account.
  6. Specify a name for the deployment.
  7. Specify the desired Git Branch. A deployment is linked to a branch. When a new revision is created, code for the linked branch will be deployed. The branch can be updated later in the Deployment Settings.
  8. Specify the full path to the LangGraph API config file including the file name. For example, if the file langgraph.json is in the root of the repository, simply specify langgraph.json.
  9. Check/uncheck checkbox to Automatically update deployment on push to branch. If checked, the deployment will automatically be updated when changes are pushed to the specified Git Branch. This setting can be enabled/disabled later in the Deployment Settings.
  10. Select the desired Deployment Type.
  11. Development deployments are meant for non-production use cases and are provisioned with minimal resources.
  12. Production deployments can serve up to 500 requests/second and are provisioned with highly available storage with automatic backups.
  13. Determine if the deployment should be Shareable through Studio.
  14. If unchecked, the deployment will only be accessible with a valid LangSmith API key for the workspace.
  15. If checked, the deployment will be accessible through Studio to any LangSmith user. A direct URL to Studio for the deployment will be provided to share with other LangSmith users.
  16. Specify Environment Variables and secrets. See the Environment Variables reference to configure additional variables for the deployment.
  17. Sensitive values such as API keys (e.g. OPENAI_API_KEY) should be specified as secrets.
  18. Additional non-secret environment variables can be specified as well.
  19. A new LangSmith Tracing Project is automatically created with the same name as the deployment.
  20. In the top-right corner, select Submit. After a few seconds, the Deployment view appears and the new deployment will be queued for provisioning.

​
Create new revision

When creating a new deployment, a new revision is created by default. Subsequent revisions can be created to deploy new code changes. Starting from the LangSmith UI…
  1. In the left-hand navigation panel, select Deployments, which contains a list of existing deployments.
  2. Select an existing deployment to create a new revision for.
  3. In the Deployment view, in the top-right corner, select + New Revision.
  4. In the New Revision modal, fill out the required fields.
  5. Specify the full path to the LangGraph API config file including the file name. For example, if the file langgraph.json is in the root of the repository, simply specify langgraph.json.
  6. Determine if the deployment should be Shareable through Studio.
  7. If unchecked, the deployment will only be accessible with a valid LangSmith API key for the workspace.
  8. If checked, the deployment will be accessible through Studio to any LangSmith user. A direct URL to Studio for the deployment will be provided to share with other LangSmith users.
  9. Specify Environment Variables and secrets. Existing secrets and environment variables are prepopulated. See the Environment Variables reference to configure additional variables for the revision.
  10. Add new secrets or environment variables.
  11. Remove existing secrets or environment variables.
  12. Update the value of existing secrets or environment variables.
  13. Select Submit. After a few seconds, the New Revision modal will close and the new revision will be queued for deployment.

​
View build and server logs

Build and server logs are available for each revision. Starting from the Deployments view:
  1. Select the desired revision from the Revisions table. A panel slides open from the right-hand side and the Build tab is selected by default, which displays build logs for the revision.
  2. In the panel, select the Server tab to view server logs for the revision. Server logs are only available after a revision has been deployed.
  3. Within the Server tab, adjust the date/time range picker as needed. By default, the date/time range picker is set to the Last 7 days.

​
View deployment metrics

Starting from the LangSmith UI…
  1. In the left-hand navigation panel, select Deployments, which contains a list of existing deployments.
  2. Select an existing deployment to monitor.
  3. Select the Monitoring tab to view the deployment metrics. See a list of all available metrics.
  4. Within the Monitoring tab, use the date/time range picker as needed. By default, the date/time range picker is set to the Last 15 minutes.

​
Interrupt revision

Interrupting a revision will stop deployment of the revision.
Undefined Behavior Interrupted revisions have undefined behavior. This is only useful if you need to deploy a new revision and you already have a revision “stuck” in progress. In the future, this feature may be removed.
Starting from the Deployments view:
  1. Select the menu icon (three dots) on the right-hand side of the row for the desired revision from the Revisions table.
  2. Select Interrupt from the menu.
  3. A modal will appear. Review the confirmation message. Select Interrupt revision.

​
Delete deployment

Starting from the LangSmith UI…
  1. In the left-hand navigation panel, select Deployments, which contains a list of existing deployments.
  2. Select the menu icon (three dots) on the right-hand side of the row for the desired deployment and select Delete.
  3. A Confirmation modal will appear. Select Delete.

​
Deployment settings

Starting from the Deployments view:
  1. In the top-right corner, select the gear icon (Deployment Settings).
  2. Update the Git Branch to the desired branch.
  3. Check/uncheck checkbox to Automatically update deployment on push to branch.
    1. Branch creation/deletion and tag creation/deletion events will not trigger an update. Only pushes to an existing branch will trigger an update.
    2. Pushes in quick succession to a branch will queue subsequent updates. Once a build completes, the most recent commit will begin building and the other queued builds will be skipped.

​
Add or remove GitHub repositories

After installing and authorizing LangChain’s hosted-langserve GitHub app, repository access for the app can be modified to add new repositories or remove existing repositories. If a new repository is created, it may need to be added explicitly.
  1. From the GitHub profile, navigate to Settings > Applications > hosted-langserve > click Configure.
  2. Under Repository access, select All repositories or Only select repositories. If Only select repositories is selected, new repositories must be explicitly added.
  3. Click Save.
  4. When creating a new deployment, the list of GitHub repositories in the dropdown menu will be updated to reflect the repository access changes.

​
Allowlisting IP addresses

All traffic from LangSmith deployments created after January 6th 2025 will come through a NAT gateway. This NAT gateway will have several static ip addresses depending on the region you are deploying in. Refer to the table below for the list of IP addresses to allowlist:
USEU
35.197.29.14634.90.213.236
34.145.102.12334.13.244.114
34.169.45.15334.32.180.189
34.82.222.1734.34.69.108
35.227.171.13534.32.145.240
34.169.88.3034.90.157.44
34.19.93.20234.141.242.180
34.19.34.5034.32.141.108
34.59.244.194
34.9.99.224
34.68.27.146
34.41.178.137
34.123.151.210
34.135.61.140
34.121.166.52
34.31.121.70
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.