Skip to content

docs(self-hosted): document per-deployment runtime env values, drop --only-deps - #6799

Merged
Ryan-Amirthan merged 8 commits into
mainfrom
devin/1788221707-self-hosted-runtime-env
Sep 1, 2026
Merged

docs(self-hosted): document per-deployment runtime env values, drop --only-deps#6799
Ryan-Amirthan merged 8 commits into
mainfrom
devin/1788221707-self-hosted-runtime-env

Conversation

@Ryan-Amirthan

@Ryan-Amirthan Ryan-Amirthan commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the deferred env var substitution shipped in fern-platform#14306 and fern#17578, and removes the deprecated fern-generate --only-deps runtime-generation flow from the self-hosted docs.

New Per-deployment values section on the self-hosted setup page, written around the customer-facing path: write the value as ${VAR} with substitute-env-vars and list its name in FERN_RUNTIME_ENV_VARS at build time, and generation rewrites it to a FERN_SELF_HOSTED_ENV_<NAME> placeholder that the container resolves from its own environment on each request. Also notes that url/custom-domain always resolve at build time, that Markdown/llms.txt and search results are substituted too, that a runtime value may include or omit a scheme, and that an unlisted or unset name renders as the literal placeholder. FERN_RUNTIME_ENV_VARS added to the env var table.

Removals: the ### Runtime generation section, the "vendor dependencies for runtime generation" air-gapped accordion (Option 3 renumbered to Option 2), and the commented --only-deps alternative in the remaining Dockerfile examples. Build-time RUN fern-generate guidance is unchanged. Translations still carry the old text and are left to the nightly sync.

Plus a changelog entry (merged alongside the search-metadata entry for the same date).

Testing

Link to Devin session: https://app.devin.ai/sessions/48343062b0d241d1b2319f33603aa999
Open in Devin Desktop: https://app.devin.ai/desktop/session/48343062b0d241d1b2319f33603aa999?variant=devin
Requested by: @Ryan-Amirthan

…-only-deps

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration

Copy link
Copy Markdown
Contributor

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

@github-actions

github-actions Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Ryan-Amirthan and others added 7 commits September 1, 2026 00:24
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@Ryan-Amirthan
Ryan-Amirthan merged commit ce24a2b into main Sep 1, 2026
4 checks passed
@Ryan-Amirthan
Ryan-Amirthan deleted the devin/1788221707-self-hosted-runtime-env branch September 1, 2026 15:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants