Skip to content

Conversation

@katmayb
Copy link
Contributor

@katmayb katmayb commented Oct 23, 2025

Fixes DOC-398, DOC-399

It was a little confusing to find app deployment instructions for self-hosted and Hybrid instances. The Deployment tab only covered Cloud (GitHub-based) deployments.

This PR creates clear separation between infrastructure setup (one-time) and application deployment (ongoing):

New file:

  • deploy-with-control-plane.mdx - Guide for deploying apps to Hybrid/Self-hosted with control plane using Docker images
    Updated files:
  • deploy-hybrid.mdx & deploy-self-hosted-full-platform.mdx - Removed app deployment steps, now focus just on infrastructure setup
  • deployments.mdx - Updated to show all three deployment paths (Cloud, Hybrid/Self-hosted with control plane, Standalone servers)

@katmayb katmayb requested a review from lnhsingh as a code owner October 23, 2025 14:43
@github-actions github-actions bot added the langsmith For docs changes to LangSmith label Oct 23, 2025
@katmayb katmayb force-pushed the sh-hosting-deployment branch from 5b98651 to 3f5fd63 Compare October 23, 2025 14:45
@katmayb katmayb requested a review from andrewnguonly October 23, 2025 14:59
@github-actions
Copy link
Contributor

Preview ID generated: preview-shhost-1761330983-0823b76

@github-actions
Copy link
Contributor

Preview ID generated: preview-shhost-1761577978-08b3d1d

@lnhsingh
Copy link
Collaborator

Copy link
Contributor

@andrewnguonly andrewnguonly left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a great update! Helps clarify a lot 👍

]
},
{
"group": "Deploy to self-hosted or hybrid",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

General suggestion/feedback, not specific to this change: It is unintuitive to me that the "deploy" sections are listed before the "development" and "configure" sections, which are prerequisites to deployment. My ordering preference:

  1. Overview (includes Quickstart so you get skip ahead to getting the app running)
  2. App development (read this first so you understand conceptually what you're about to deploy)
  3. Configure for deployment (read this second so you understand how to configure the deployment)
  4. Deploy to cloud (do the deployment)
  5. Deploy to self-hosted or hybrid

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Separate idea (not blocking): It feels like the "deploy" sections can be consolidated under one navigation header, but maybe it's still different enough to have different sections.

We can come back to this later.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm going to leave this for now and have Kathryn address the nav order / consolidation when she's back. Filed an issue for her: https://linear.app/langchain/issue/DOC-408/rearrange-langsmith-nav

Push your image to a container registry accessible by your Kubernetes cluster. The specific commands depend on your registry provider.

<Tip>
Tag your images with version information (e.g., `my-registry.com/my-app:v1.0.0`) to make rollbacks easier.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔥

@github-actions
Copy link
Contributor

Preview ID generated: preview-shhost-1761665890-d433a4b

@github-actions
Copy link
Contributor

Preview ID generated: preview-shhost-1761666130-983694a

@lnhsingh lnhsingh merged commit e96586a into main Oct 28, 2025
11 checks passed
@lnhsingh lnhsingh deleted the sh-hosting-deployment branch October 28, 2025 15:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

langsmith For docs changes to LangSmith

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants