Skip to content

Add environment variables configuration page for self-hosted Helm chart#4188

Draft
langsmith-fleet[bot] wants to merge 1 commit into
mainfrom
docs/document-commonenv-vs-extraenv
Draft

Add environment variables configuration page for self-hosted Helm chart#4188
langsmith-fleet[bot] wants to merge 1 commit into
mainfrom
docs/document-commonenv-vs-extraenv

Conversation

@langsmith-fleet
Copy link
Copy Markdown
Contributor

Fixes DOC-1174

Summary

  • Adds a new page self-host-environment-variables.mdx to the Platform setup → Self-hosted → Configuration section
  • Documents commonEnv vs extraEnv in the LangSmith Helm chart, including:
    • What commonEnv is and which services receive it (backend, platformBackend, queue, ingestQueue, frontend, hostBackend)
    • Which services do not receive commonEnv (playground, aceBackend) and how to configure them via their own extraEnv
    • The duplicate variable detection behavior: the chart's detectDuplicates helper causes a hard Helm render failure when the same variable name appears more than once per service
    • A practical example showing how to set a variable for most services via commonEnv while configuring sandbox services separately

Links

Verification

Not run; docs-only content page. Verified technical details against the Helm chart values.yaml (lines 15–21) and _helpers.tpl (lines 870–889).

Reviewers

Requested review from: Kathryn May (@katmayb), Florence Morris (@fjmorris)

Document the difference between commonEnv and extraEnv, which services
receive commonEnv (all except playground and aceBackend), and the hard
failure that occurs when duplicate variable names are detected.
@github-actions github-actions Bot added langsmith For docs changes to LangSmith external User is not a member of langchain-ai labels May 28, 2026
@github-actions
Copy link
Copy Markdown
Contributor

Mintlify preview branch generated: preview-docsdo-1779981383-3e8c739

Site preview: https://langchain-5e9cc07a-preview-docsdo-1779981383-3e8c739.mintlify.app

Preview links may take a few minutes to start working while the deployment finishes.

Changed documentation pages (preview deep links):

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

external User is not a member of langchain-ai langsmith For docs changes to LangSmith

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant