Skip to content

docs(sandboxes): forking, private networking, templates, and create variables#1182

Merged
MykalMachon merged 3 commits into
mainfrom
mykal/sandbox-forking-and-privnet
Jun 4, 2026
Merged

docs(sandboxes): forking, private networking, templates, and create variables#1182
MykalMachon merged 3 commits into
mainfrom
mykal/sandbox-forking-and-privnet

Conversation

@MykalMachon
Copy link
Copy Markdown
Contributor

What

Documents the sandbox capabilities that landed in the last day, across the platform, the CLI (railwayapp/cli #933), and the TypeScript SDK. Surfaces only the user-facing changes; internal work (tombstoning, slow-activity heartbeating) is intentionally omitted.

sandboxes.md

  • Networking rewritten from "always isolated" to the two isolation modes: ISOLATED (default) and PRIVATE, with SDK and CLI snippets.
  • Forking SDK subsection (source.fork() / Sandbox.create(source)), plus a line in the create-methods list.
  • CLI blurb updated to mention fork, templates, and variables.

cli/sandbox.md

  • New fork and template subcommands (examples + option tables).
  • New Templates, Variables, and Private networking sections.
  • --variable, --env-file, --template, --private-network added to create; full Options for fork.

Notes

  • Runtime variables (--variable / --env-file) are documented under the CLI only. The SDK's create/fork options expose idleTimeoutMinutes and networkIsolation but not runtime variables, so they aren't claimed for the SDK.
  • Reconciled with the idle-timeout definition that landed on main (docs: add sandboxing idle definition #1181): the new fork option reuses the /sandboxes#idle-timeout link for consistency.

🤖 Generated with Claude Code

… create variables

Cover the sandbox capabilities that landed in the CLI (railwayapp/cli #933)
and the TypeScript SDK: forking a running sandbox, the ISOLATED/PRIVATE
network isolation modes, building and booting from templates, and seeding
variables at create time via the CLI. Reconcile with the idle-timeout
definition added on main.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@railway-app railway-app Bot temporarily deployed to *.railway.com / docs-pr-1182 June 4, 2026 15:50 Destroyed
@railway-app
Copy link
Copy Markdown

railway-app Bot commented Jun 4, 2026

🚅 Deployed to the docs-pr-1182 environment in 🪄 *.railway.com

Service Status Web Updated (UTC)
Image Docs Frontend ✅ Success (View Logs) Web Jun 4, 2026 at 3:58 pm
8 services not affected by this PR
  • devicons
  • OG
  • Frontend Redis
  • Turnout
  • Meilisearch
  • Geofeed
  • Blog
  • railway.com

Remove colloquial and future-tense phrasing flagged by the docs-writing
skill: "flags win" -> "take precedence", "does the same thing as" ->
"is equivalent to", and the pricing line's "will be announced soon" ->
present-tense "Railway hasn't announced sandbox pricing yet".

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@railway-app railway-app Bot temporarily deployed to *.railway.com / docs-pr-1182 June 4, 2026 15:54 Destroyed
Revert the pricing line to "will be announced soon" — it's deliberate
team-lead copy, not an accidental style violation.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@railway-app railway-app Bot temporarily deployed to *.railway.com / docs-pr-1182 June 4, 2026 15:55 Destroyed
@MykalMachon MykalMachon merged commit 8ee9f63 into main Jun 4, 2026
7 checks passed
@MykalMachon MykalMachon deleted the mykal/sandbox-forking-and-privnet branch June 4, 2026 16:01
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.

1 participant