From 14acd94ba22b8e8162fde33e4bbb3fa311b1ccca Mon Sep 17 00:00:00 2001 From: Jo Franchetti Date: Wed, 14 Jan 2026 14:46:27 +0000 Subject: [PATCH 1/7] update mention of sandboxes to Deno Sandbox (singular) --- _components/Header.tsx | 2 +- _config.ts | 2 +- _includes/layout.tsx | 4 +- _includes/sandbox-example.tsx | 6 +-- deploy/_data.ts | 4 +- deploy/changelog.md | 10 ++-- deploy/classic/_data.ts | 4 +- deploy/reference/runtime.md | 2 +- examples/_data.ts | 34 ++++++------ .../{sandboxes => sandbox}/access_output.md | 2 +- .../command_cancellation.md | 2 +- .../custom_error_classes.md | 2 +- .../environment_variables.md | 2 +- .../{sandboxes => sandbox}/error_handling.md | 2 +- .../evaluating_javascript.md | 2 +- .../{sandboxes => sandbox}/javascript_repl.md | 2 +- examples/{sandboxes => sandbox}/memory.md | 2 +- .../spawn_subprocess.md | 2 +- examples/{sandboxes => sandbox}/ssh_access.md | 2 +- .../{sandboxes => sandbox}/stream_output.md | 2 +- .../template_literals.md | 2 +- .../{sandboxes => sandbox}/timeout_control.md | 2 +- .../{sandboxes => sandbox}/upload_files.md | 2 +- .../{sandboxes => sandbox}/vscode_instance.md | 2 +- .../{sandboxes => sandbox}/web_framework.md | 6 +-- runtime/reference/cli/deploy.md | 2 +- {sandboxes => sandbox}/_data.ts | 32 +++++------ {sandboxes => sandbox}/cli.md | 51 +++++++++--------- {sandboxes => sandbox}/create.md | 6 +-- {sandboxes => sandbox}/expose_http.md | 4 +- {sandboxes => sandbox}/getting_started.md | 31 +++++------ {sandboxes => sandbox}/images/org-tokens.webp | Bin .../images/sandbox-event-log.webp | Bin .../images/sandbox-list.webp | Bin {sandboxes => sandbox}/index.md | 36 ++++++------- {sandboxes => sandbox}/manage_apps.md | 0 {sandboxes => sandbox}/promote.md | 8 +-- {sandboxes => sandbox}/security.md | 8 +-- {sandboxes => sandbox}/ssh.md | 6 +-- {sandboxes => sandbox}/timeouts.md | 11 ++-- {sandboxes => sandbox}/volumes.md | 2 +- services/_data.ts | 4 +- subhosting/_data.ts | 4 +- 43 files changed, 156 insertions(+), 153 deletions(-) rename examples/{sandboxes => sandbox}/access_output.md (94%) rename examples/{sandboxes => sandbox}/command_cancellation.md (93%) rename examples/{sandboxes => sandbox}/custom_error_classes.md (92%) rename examples/{sandboxes => sandbox}/environment_variables.md (92%) rename examples/{sandboxes => sandbox}/error_handling.md (94%) rename examples/{sandboxes => sandbox}/evaluating_javascript.md (89%) rename examples/{sandboxes => sandbox}/javascript_repl.md (94%) rename examples/{sandboxes => sandbox}/memory.md (97%) rename examples/{sandboxes => sandbox}/spawn_subprocess.md (92%) rename examples/{sandboxes => sandbox}/ssh_access.md (94%) rename examples/{sandboxes => sandbox}/stream_output.md (95%) rename examples/{sandboxes => sandbox}/template_literals.md (94%) rename examples/{sandboxes => sandbox}/timeout_control.md (96%) rename examples/{sandboxes => sandbox}/upload_files.md (93%) rename examples/{sandboxes => sandbox}/vscode_instance.md (94%) rename examples/{sandboxes => sandbox}/web_framework.md (90%) rename {sandboxes => sandbox}/_data.ts (68%) rename {sandboxes => sandbox}/cli.md (89%) rename {sandboxes => sandbox}/create.md (96%) rename {sandboxes => sandbox}/expose_http.md (96%) rename {sandboxes => sandbox}/getting_started.md (82%) rename {sandboxes => sandbox}/images/org-tokens.webp (100%) rename {sandboxes => sandbox}/images/sandbox-event-log.webp (100%) rename {sandboxes => sandbox}/images/sandbox-list.webp (100%) rename {sandboxes => sandbox}/index.md (76%) rename {sandboxes => sandbox}/manage_apps.md (100%) rename {sandboxes => sandbox}/promote.md (87%) rename {sandboxes => sandbox}/security.md (92%) rename {sandboxes => sandbox}/ssh.md (94%) rename {sandboxes => sandbox}/timeouts.md (79%) rename {sandboxes => sandbox}/volumes.md (97%) diff --git a/_components/Header.tsx b/_components/Header.tsx index f274d343c..281e36ca1 100644 --- a/_components/Header.tsx +++ b/_components/Header.tsx @@ -11,7 +11,7 @@ export default function ( const hrefIsInCurrentSection = (href: string, currentSection: string) => { return href.includes(currentSection) || href === "/services/" && - ["deploy", "subhosting", "services", "sandboxes"].includes( + ["deploy", "subhosting", "services", "sandbox"].includes( currentSection, ); }; diff --git a/_config.ts b/_config.ts index 91210c9c7..09802a481 100644 --- a/_config.ts +++ b/_config.ts @@ -137,7 +137,7 @@ site.copy("deploy/images"); site.copy("deploy/classic/images"); site.copy("deploy/kv/images"); site.copy("deploy/tutorials/images"); -site.copy("sandboxes/images"); +site.copy("sandbox/images"); site.copy("runtime/fundamentals/images"); site.copy("runtime/getting_started/images"); site.copy("runtime/reference/images"); diff --git a/_includes/layout.tsx b/_includes/layout.tsx index 829e20338..ab4cc8007 100644 --- a/_includes/layout.tsx +++ b/_includes/layout.tsx @@ -11,13 +11,13 @@ export default function Layout(data: Lume.Data) { const isServicesPage = data.url.startsWith("/deploy") || data.url.startsWith("/subhosting") || data.url.startsWith("/services") || - data.url.startsWith("/sandboxes"); + data.url.startsWith("/sandbox"); const hasSubNav = isServicesPage; return ( - + {deleteBackticks(data.title)} diff --git a/_includes/sandbox-example.tsx b/_includes/sandbox-example.tsx index b88092c0f..25ede6d72 100644 --- a/_includes/sandbox-example.tsx +++ b/_includes/sandbox-example.tsx @@ -4,7 +4,7 @@ export default function Raw(data: Lume.Data) { return ( <>

- Deno Sandboxes{" "} + Deno Sandbox{" "} provide a sandboxed environment for evaluating JavaScript code. This is useful for evaluating code that is not trusted or for testing code that is not safe to run in the main runtime. @@ -13,8 +13,8 @@ export default function Raw(data: Lume.Data) { {data.children}

- For more information about Sandboxes, see the{" "} - Sandboxes documentation. + For more information about Sandbox, see the{" "} + Sandbox documentation.

); diff --git a/deploy/_data.ts b/deploy/_data.ts index 7e017201d..bc2034cf5 100644 --- a/deploy/_data.ts +++ b/deploy/_data.ts @@ -154,8 +154,8 @@ export const SidebarNav = [ href: "/deploy/", }, { - title: "Sandboxes", - href: "/sandboxes/", + title: "Deno Sandbox", + href: "/sandbox/", }, { title: "Deploy Classic", diff --git a/deploy/changelog.md b/deploy/changelog.md index e704e436f..03440de6b 100644 --- a/deploy/changelog.md +++ b/deploy/changelog.md @@ -47,16 +47,16 @@ description: "Listing notable progress in the development and evolution of Deno Code Execution) and [CVE-2025-55184/CVE-2025-67779](https://deno.com/blog/cve-2025-55184) (Denial of Service). -- And one more thing at the end: we've quietly enabled our new sandboxes +- And one more thing at the end: we've quietly enabled our new Deno Sandbox infrastructure for all Deno Deploy users to try. - - Sandboxes provide fully isolated Linux microVMs for you to run untrusted + - Deno Sandbox provides fully isolated Linux microVMs for you to run untrusted code in. - This is particularly useful for running third-party code, such as plugins, extensions, or user-generated or LLM-generated code, without risking the security of your application. - - We'll announce more details about sandboxes in the new year, so stay tuned! - - Try it out from the "Sandboxes" tab in the organization overview. - - [Learn more about sandboxes.](https://deno.com/deploy/sandboxes) + - We'll announce more details about Deno Sandbox in the new year, so stay tuned! + - Try it out from the "Sandbox" tab in the organization overview. + - [Learn more about Deno Sandbox.](https://deno.com/deploy/sandbox) ### Bug fixes diff --git a/deploy/classic/_data.ts b/deploy/classic/_data.ts index 3b7262cc3..2f61ac7be 100644 --- a/deploy/classic/_data.ts +++ b/deploy/classic/_data.ts @@ -125,8 +125,8 @@ export const SidebarNav = [ href: "/deploy/", }, { - title: "Sandboxes", - href: "/sandboxes/", + title: "Deno Sandbox", + href: "/sandbox/", }, { title: "Deploy Classic", diff --git a/deploy/reference/runtime.md b/deploy/reference/runtime.md index 59e25514c..1bb96e16e 100644 --- a/deploy/reference/runtime.md +++ b/deploy/reference/runtime.md @@ -105,7 +105,7 @@ applications, and within a few hundred milliseconds for larger applications. Deno Deploy uses multiple optimizations to enable fast cold starts: -- Sandboxes and the Deno runtime are pre-provisioned to ensure they don't need +- Deno Sandbox and the Deno runtime are pre-provisioned to ensure they don't need to be created from scratch when starting an application. - Applications start immediately when the client sends the first TCP packet to diff --git a/examples/_data.ts b/examples/_data.ts index d5083fe2e..1eb66e614 100644 --- a/examples/_data.ts +++ b/examples/_data.ts @@ -301,86 +301,86 @@ export const sidebar = [ ], }, { - title: "Sandboxes", + title: "Deno Sandbox", items: [ { title: "Evaluating JavaScript", - href: "/examples/sandboxes_evaluating_javascript/", + href: "/examples/sandbox_evaluating_javascript/", type: "example", }, { title: "Spawn a subprocess", - href: "/examples/sandboxes_spawn_subprocess/", + href: "/examples/sandbox_spawn_subprocess/", type: "example", }, { title: "Serve a web framework", - href: "/examples/sandboxes_web_framework/", + href: "/examples/sandbox_web_framework/", type: "example", }, { title: "Privide SSH access to a sandbox", - href: "/examples/sandboxes_ssh_access/", + href: "/examples/sandbox_ssh_access/", type: "example", }, { title: "Intereactive JavaScript REPL", - href: "/examples/sandboxes_javascript_repl/", + href: "/examples/sandbox_javascript_repl/", type: "example", }, { title: "Provide a VSCode instance in a sandbox", - href: "/examples/sandboxes_vscode_instance/", + href: "/examples/sandbox_vscode_instance/", type: "example", }, { title: "Use template literals with variable interpolation", - href: "/examples/sandboxes_template_literals/", + href: "/examples/sandbox_template_literals/", type: "example", }, { title: "Error handling", - href: "/examples/sandboxes_error_handling/", + href: "/examples/sandbox_error_handling/", type: "example", }, { title: "Error handling with custom error classes", - href: "/examples/sandboxes_custom_error_classes/", + href: "/examples/sandbox_custom_error_classes/", type: "example", }, { title: "Command cancellation", - href: "/examples/sandboxes_command_cancellation/", + href: "/examples/sandbox_command_cancellation/", type: "example", }, { title: "Access string and binary output", - href: "/examples/sandboxes_access_output/", + href: "/examples/sandbox_access_output/", type: "example", }, { title: "Set and get environment variables", - href: "/examples/sandboxes_environment_variables/", + href: "/examples/sandbox_environment_variables/", type: "example", }, { title: "Stream output to a local file", - href: "/examples/sandboxes_stream_output/", + href: "/examples/sandbox_stream_output/", type: "example", }, { title: "Upload files and directories to a sandbox", - href: "/examples/sandboxes_upload_files/", + href: "/examples/sandbox_upload_files/", type: "example", }, { title: "Control sandbox timeout", - href: "/examples/sandboxes_timeout_control/", + href: "/examples/sandbox_timeout_control/", type: "example", }, { title: "Configure sandbox memory", - href: "/examples/sandboxes_memory/", + href: "/examples/sandbox_memory/", type: "example", }, ], diff --git a/examples/sandboxes/access_output.md b/examples/sandbox/access_output.md similarity index 94% rename from examples/sandboxes/access_output.md rename to examples/sandbox/access_output.md index ab82f2c68..6876c6258 100644 --- a/examples/sandboxes/access_output.md +++ b/examples/sandbox/access_output.md @@ -1,7 +1,7 @@ --- title: "Access string and binary output" description: "Learn how to access string and binary output from commands in a sandbox." -url: /examples/sandboxes_access_output/ +url: /examples/sandbox_access_output/ layout: sandbox-example.tsx --- diff --git a/examples/sandboxes/command_cancellation.md b/examples/sandbox/command_cancellation.md similarity index 93% rename from examples/sandboxes/command_cancellation.md rename to examples/sandbox/command_cancellation.md index c10bdce72..65235ba97 100644 --- a/examples/sandboxes/command_cancellation.md +++ b/examples/sandbox/command_cancellation.md @@ -1,7 +1,7 @@ --- title: "Command cancellation" description: "Learn how to cancel commands in a sandbox." -url: /examples/sandboxes_command_cancellation/ +url: /examples/sandbox_command_cancellation/ layout: sandbox-example.tsx --- diff --git a/examples/sandboxes/custom_error_classes.md b/examples/sandbox/custom_error_classes.md similarity index 92% rename from examples/sandboxes/custom_error_classes.md rename to examples/sandbox/custom_error_classes.md index f60d85504..ff369c38e 100644 --- a/examples/sandboxes/custom_error_classes.md +++ b/examples/sandbox/custom_error_classes.md @@ -1,7 +1,7 @@ --- title: "Error handling with custom error classes" description: "Learn how to handle errors with custom error classes in a sandbox." -url: /examples/sandboxes_custom_error_classes/ +url: /examples/sandbox_custom_error_classes/ layout: sandbox-example.tsx --- diff --git a/examples/sandboxes/environment_variables.md b/examples/sandbox/environment_variables.md similarity index 92% rename from examples/sandboxes/environment_variables.md rename to examples/sandbox/environment_variables.md index ab0c9026a..590b7d367 100644 --- a/examples/sandboxes/environment_variables.md +++ b/examples/sandbox/environment_variables.md @@ -1,7 +1,7 @@ --- title: "Set and get environment variables" description: "Learn how to set and get environment variables in a sandbox." -url: /examples/sandboxes_environment_variables/ +url: /examples/sandbox_environment_variables/ layout: sandbox-example.tsx --- diff --git a/examples/sandboxes/error_handling.md b/examples/sandbox/error_handling.md similarity index 94% rename from examples/sandboxes/error_handling.md rename to examples/sandbox/error_handling.md index 65c6bccc6..492ac59b3 100644 --- a/examples/sandboxes/error_handling.md +++ b/examples/sandbox/error_handling.md @@ -1,7 +1,7 @@ --- title: "Error handling" description: "Learn how to handle errors in a sandbox." -url: /examples/sandboxes_error_handling/ +url: /examples/sandbox_error_handling/ layout: sandbox-example.tsx --- diff --git a/examples/sandboxes/evaluating_javascript.md b/examples/sandbox/evaluating_javascript.md similarity index 89% rename from examples/sandboxes/evaluating_javascript.md rename to examples/sandbox/evaluating_javascript.md index 98dd40e55..6bae5f55e 100644 --- a/examples/sandboxes/evaluating_javascript.md +++ b/examples/sandbox/evaluating_javascript.md @@ -1,7 +1,7 @@ --- title: "Evaluating JavaScript" description: "Learn how to evaluate JavaScript code in a sandbox." -url: /examples/sandboxes_evaluating_javascript/ +url: /examples/sandbox_evaluating_javascript/ layout: sandbox-example.tsx --- diff --git a/examples/sandboxes/javascript_repl.md b/examples/sandbox/javascript_repl.md similarity index 94% rename from examples/sandboxes/javascript_repl.md rename to examples/sandbox/javascript_repl.md index 23d68dfd8..4a781d1ea 100644 --- a/examples/sandboxes/javascript_repl.md +++ b/examples/sandbox/javascript_repl.md @@ -1,7 +1,7 @@ --- title: "Intereactive JavaScript REPL" description: "Learn how to provide an interactive Deno REPL in a sandbox." -url: /examples/sandboxes_javascript_repl/ +url: /examples/sandbox_javascript_repl/ layout: sandbox-example.tsx --- diff --git a/examples/sandboxes/memory.md b/examples/sandbox/memory.md similarity index 97% rename from examples/sandboxes/memory.md rename to examples/sandbox/memory.md index 5229bdd97..bf6281ddf 100644 --- a/examples/sandboxes/memory.md +++ b/examples/sandbox/memory.md @@ -1,7 +1,7 @@ --- title: "Configure sandbox memory" description: "Learn how to configure the memory allocated to a sandbox" -url: /examples/sandboxes_memory/ +url: /examples/sandbox_memory/ layout: sandbox-example.tsx --- diff --git a/examples/sandboxes/spawn_subprocess.md b/examples/sandbox/spawn_subprocess.md similarity index 92% rename from examples/sandboxes/spawn_subprocess.md rename to examples/sandbox/spawn_subprocess.md index 54c452b3b..b5aed396d 100644 --- a/examples/sandboxes/spawn_subprocess.md +++ b/examples/sandbox/spawn_subprocess.md @@ -1,7 +1,7 @@ --- title: "Spawn a subprocess, and get buffered output" description: "Learn how to spawn a subprocess, and get buffered output in a sandbox." -url: /examples/sandboxes_spawn_subprocess/ +url: /examples/sandbox_spawn_subprocess/ layout: sandbox-example.tsx --- diff --git a/examples/sandboxes/ssh_access.md b/examples/sandbox/ssh_access.md similarity index 94% rename from examples/sandboxes/ssh_access.md rename to examples/sandbox/ssh_access.md index 4e6a2e297..fa64811d0 100644 --- a/examples/sandboxes/ssh_access.md +++ b/examples/sandbox/ssh_access.md @@ -1,7 +1,7 @@ --- title: "Provide SSH access to a sandbox" description: "Learn how to provide SSH access to a sandbox." -url: /examples/sandboxes_ssh_access/ +url: /examples/sandbox_ssh_access/ layout: sandbox-example.tsx --- diff --git a/examples/sandboxes/stream_output.md b/examples/sandbox/stream_output.md similarity index 95% rename from examples/sandboxes/stream_output.md rename to examples/sandbox/stream_output.md index 83dd5f43c..5a777ac7f 100644 --- a/examples/sandboxes/stream_output.md +++ b/examples/sandbox/stream_output.md @@ -1,7 +1,7 @@ --- title: "Stream output to a local file" description: "Learn how to stream output to a local file in a sandbox." -url: /examples/sandboxes_stream_output/ +url: /examples/sandbox_stream_output/ layout: sandbox-example.tsx --- diff --git a/examples/sandboxes/template_literals.md b/examples/sandbox/template_literals.md similarity index 94% rename from examples/sandboxes/template_literals.md rename to examples/sandbox/template_literals.md index 558983412..b52b9347c 100644 --- a/examples/sandboxes/template_literals.md +++ b/examples/sandbox/template_literals.md @@ -1,7 +1,7 @@ --- title: "Template literal commands with variable interpolation" description: "Learn how to use template literal commands with variable interpolation in a sandbox." -url: /examples/sandboxes_template_literals/ +url: /examples/sandbox_template_literals/ layout: sandbox-example.tsx --- diff --git a/examples/sandboxes/timeout_control.md b/examples/sandbox/timeout_control.md similarity index 96% rename from examples/sandboxes/timeout_control.md rename to examples/sandbox/timeout_control.md index 3d8d07d63..eeccb675b 100644 --- a/examples/sandboxes/timeout_control.md +++ b/examples/sandbox/timeout_control.md @@ -1,7 +1,7 @@ --- title: "Control sandbox timeout" description: "Learn how to control how long your sandbox stays alive using the timeout option." -url: /examples/sandboxes_timeout_control/ +url: /examples/sandbox_timeout_control/ layout: sandbox-example.tsx --- diff --git a/examples/sandboxes/upload_files.md b/examples/sandbox/upload_files.md similarity index 93% rename from examples/sandboxes/upload_files.md rename to examples/sandbox/upload_files.md index 7ef40dd61..1642f1eb9 100644 --- a/examples/sandboxes/upload_files.md +++ b/examples/sandbox/upload_files.md @@ -1,7 +1,7 @@ --- title: "Upload files and directories" description: "Learn how to upload files and directories to a sandbox." -url: /examples/sandboxes_upload_files/ +url: /examples/sandbox_upload_files/ layout: sandbox-example.tsx --- diff --git a/examples/sandboxes/vscode_instance.md b/examples/sandbox/vscode_instance.md similarity index 94% rename from examples/sandboxes/vscode_instance.md rename to examples/sandbox/vscode_instance.md index 853f70965..0d029dc3d 100644 --- a/examples/sandboxes/vscode_instance.md +++ b/examples/sandbox/vscode_instance.md @@ -1,7 +1,7 @@ --- title: "Provide a VSCode instance in a sandbox" description: "Learn how to provide a VSCode instance in a sandbox." -url: /examples/sandboxes_vscode_instance/ +url: /examples/sandbox_vscode_instance/ layout: sandbox-example.tsx --- diff --git a/examples/sandboxes/web_framework.md b/examples/sandbox/web_framework.md similarity index 90% rename from examples/sandboxes/web_framework.md rename to examples/sandbox/web_framework.md index 470d85a98..c0dcc13c4 100644 --- a/examples/sandboxes/web_framework.md +++ b/examples/sandbox/web_framework.md @@ -1,12 +1,12 @@ --- title: "Serve a web framework" description: "Create a package.json, install deps, run a web framework (Express), and expose it publicly from a sandbox" -url: /examples/sandboxes_web_framework/ +url: /examples/sandbox_web_framework/ layout: sandbox-example.tsx --- -In sandboxes, you can create a `package.json`, install dependencies, run a web -framework (Express), and expose it publicly over HTTP. +With Deno Sandbox you can create a `package.json`, install dependencies, run a +web framework (Express), and expose it publicly over HTTP. This example shows how to create a minimal Express app inside the sandbox, runs it on port 3000, and exposes it publicly using `sandbox.exposeHttp()`. diff --git a/runtime/reference/cli/deploy.md b/runtime/reference/cli/deploy.md index 127a1f23c..30439d5f0 100644 --- a/runtime/reference/cli/deploy.md +++ b/runtime/reference/cli/deploy.md @@ -151,7 +151,7 @@ deno deploy logs deno deploy logs --org my-org --app my-app --start "2024-01-01T00:00:00Z" ``` -### Sandbox management +### Deno Sandbox management Interact with running sandboxes directly from the Deploy CLI. diff --git a/sandboxes/_data.ts b/sandbox/_data.ts similarity index 68% rename from sandboxes/_data.ts rename to sandbox/_data.ts index e903b1ab2..471efddfe 100644 --- a/sandboxes/_data.ts +++ b/sandbox/_data.ts @@ -2,20 +2,20 @@ import { Sidebar, SidebarNav } from "../types.ts"; export const sidebar = [ { - title: "Sandboxes", + title: "Sandbox", items: [ - { title: "About", href: "/sandboxes/" }, + { title: "About", href: "/sandbox/" }, { title: "Getting started", - href: "/sandboxes/getting_started/", + href: "/sandbox/getting_started/", }, { title: "Create a sandbox", - href: "/sandboxes/create/", + href: "/sandbox/create/", }, { title: "Management via CLI", - href: "/sandboxes/cli/", + href: "/sandbox/cli/", }, ], }, @@ -24,27 +24,27 @@ export const sidebar = [ items: [ { title: "Expose HTTP", - href: "/sandboxes/expose_http/", + href: "/sandbox/expose_http/", }, { title: "SSH", - href: "/sandboxes/ssh/", + href: "/sandbox/ssh/", }, { title: "Manage Deploy apps", - href: "/sandboxes/manage_apps/", + href: "/sandbox/manage_apps/", }, { title: "Volumes", - href: "/sandboxes/volumes/", + href: "/sandbox/volumes/", }, { title: "Timeouts", - href: "/sandboxes/timeouts/", + href: "/sandbox/timeouts/", }, { title: "Security", - href: "/sandboxes/security/", + href: "/sandbox/security/", }, ], }, @@ -61,7 +61,7 @@ export const sidebar = [ }, { title: "Examples", - href: "/examples/#sandboxes", + href: "/examples/#sandbox", }, { title: "Pricing", @@ -71,16 +71,16 @@ export const sidebar = [ }, ] satisfies Sidebar; -export const sectionTitle = "Sandboxes"; -export const sectionHref = "/sandboxes/"; +export const sectionTitle = "Sandbox"; +export const sectionHref = "/sandbox/"; export const SidebarNav = [ { title: "Deno Deploy", href: "/deploy/", }, { - title: "Sandboxes", - href: "/sandboxes/", + title: "Sandbox", + href: "/sandbox/", }, { title: "Deploy Classic", diff --git a/sandboxes/cli.md b/sandbox/cli.md similarity index 89% rename from sandboxes/cli.md rename to sandbox/cli.md index 7edb935f8..ad4946403 100644 --- a/sandboxes/cli.md +++ b/sandbox/cli.md @@ -1,15 +1,16 @@ --- title: "Management via CLI" -description: "Overview of how to manage sandboxes using the Deno CLI." +description: "How to manage Deno Sandbox with the Deno CLI." --- -The Deno CLI includes built-in commands for managing sandboxes, allowing you to -create, control, and interact with them from your terminal. +The Deno CLI includes built-in commands for managing your Deno Sandbox +instances, allowing you to create, control, and interact with them from your +terminal. -This integration makes sandbox management feel natural within your existing Deno +This integration makes Deno Sandbox management feel natural within your existing Deno workflow. -## Creating Your First Sandbox +## Creating your first Deno Sandbox The simplest way to get started is with `deno sandbox create`. By default, this creates an interactive session-based sandbox that automatically opens an SSH @@ -80,7 +81,7 @@ Complex workflows can be expressed as quoted command chains: deno sandbox create --copy ./app --cwd /app "npm install && npm test && npm run build" ``` -## Viewing Your Sandboxes +## Viewing your Deno Sandbox Use `deno sandbox list` (or `deno sandbox ls`) to see all sandboxes in your organization: @@ -96,7 +97,7 @@ This shows each sandbox's unique ID (which you'll use with other commands), when it was created, whether it's currently running, and how long it's been active. The sandbox ID is a UUID that uniquely identifies each instance. -## Running Commands Remotely +## Running commands remotely The `deno sandbox exec` command lets you run individual commands in any running sandbox without opening an interactive session. This is perfect for automation, @@ -141,13 +142,13 @@ cat large-dataset.csv | deno sandbox exec 550e8400-e29b-41d4-a716-446655440000 - This makes it easy to integrate sandbox processing into larger Unix workflows and data pipelines. -## Transferring Files +## Transferring files -While you can copy files during sandbox creation, you might need to update or -retrieve files later. The `deno sandbox copy` command (also available as +While you can copy files during Deno Sandbox creation, you might need to update +or retrieve files later. The `deno sandbox copy` command (also available as `deno sandbox cp`) transfers files in any direction: from your local machine to -sandboxes, from sandboxes back to your machine, or even between different -sandboxes. +a Deno Sandbox, from a Deno Sandbox back to your machine, or even between +different sandboxes. Copy files from your local machine to a sandbox: @@ -167,7 +168,7 @@ Copy files between different sandboxes: deno sandbox copy 550e8400-e29b-41d4-a716-446655440000:/app/data.csv 6ba7b810-9dad-11d1-80b4-00c04fd430c8:/app/input/ ``` -You can use glob patterns to copy multiple files from sandboxes: +You can use glob patterns to copy multiple files from Deno Sandbox: ```bash deno sandbox copy 550e8400-e29b-41d4-a716-446655440000:/app/*.json ./config/ @@ -186,7 +187,7 @@ The target path can be customized to organize files within the sandbox: deno sandbox copy ./frontend 550e8400-e29b-41d4-a716-446655440000:/app/web/ ``` -## Deploying Sandboxes +## Deploying Deno Sandbox You can deploy a running sandbox to a Deno Deploy app using the `deno sandbox deploy` command: @@ -214,12 +215,12 @@ To pass arguments to the entrypoint script: deno sandbox deploy --args --port 8080 550e8400-e29b-41d4-a716-446655440000 my-app ``` -## Managing Volumes +## Managing volumes The sandbox system supports persistent volumes for data that needs to survive across sandbox instances. Use the `deno sandbox volumes` command to manage them. -### Creating Volumes +### Creating volumes Create a new volume with a specific name, capacity, and region: @@ -227,7 +228,7 @@ Create a new volume with a specific name, capacity, and region: deno sandbox volumes create my-data --capacity 10gb --region ord ``` -### Listing Volumes +### Listing volumes List all volumes in your organization: @@ -241,7 +242,7 @@ You can also search for specific volumes: deno sandbox volumes list my-data ``` -### Deleting Volumes +### Deleting volumes Remove a volume when you no longer need it: @@ -249,7 +250,7 @@ Remove a volume when you no longer need it: deno sandbox volumes delete my-data ``` -## Interactive Access +## Interactive access When you need to work interactively within a sandbox; be it editing files, debugging issues, or exploring the environment, you can use `deno sandbox ssh`: @@ -264,9 +265,9 @@ additional software as needed. The sandbox continues running after you disconnect, so you can reconnect later or use other commands to interact with it remotely. -## Managing Sandbox Timeout +## Managing Deno Sandbox timeout -### Extending Sandbox Duration +### Extending Deno Sandbox duration Sometimes you'll need more time to complete your work in a running sandbox. The `deno sandbox extend` command allows you to extend the timeout of any running @@ -281,7 +282,7 @@ into it, running remote commands, or have background processes running. All active connections and processes continue uninterrupted while the sandbox's expiration time is updated. -### Cleanup and Termination +### Cleanup and termination When you're finished with a sandbox, use `deno sandbox kill` (or `deno sandbox rm`) to terminate it and free up resources: @@ -294,9 +295,9 @@ This immediately stops all processes in the sandbox and releases its resources. Be sure to save any important work before terminating a sandbox, as all data inside will be lost. -## Common Workflows +## Common workflows -### Development and Testing +### Development and testing A typical development workflow involves creating a sandbox with your code, setting up dependencies, and running tests: @@ -321,7 +322,7 @@ deno sandbox copy 550e8400-e29b-41d4-a716-446655440000:/app/build/ ./dist/ deno sandbox kill 550e8400-e29b-41d4-a716-446655440000 ``` -### Data Processing +### Data processing For data processing workflows where you need to retrieve results, use a combination of remote execution and SSH access: diff --git a/sandboxes/create.md b/sandbox/create.md similarity index 96% rename from sandboxes/create.md rename to sandbox/create.md index 95937a3f0..7034954a1 100644 --- a/sandboxes/create.md +++ b/sandbox/create.md @@ -1,5 +1,5 @@ --- -title: "Create a Sandbox" +title: "Create a Deno Sandbox" description: "Learn how to provision a sandbox with the static Sandbox.create() method and configure runtime, network, and lifecycle options." --- @@ -93,5 +93,5 @@ const sandbox = await Sandbox.create({ - Let `await using` (or dropping the last reference) dispose of the sandbox automatically. Call `sandbox.kill()` only when you need to terminate it prior to that automatic cleanup. -- For long-lived services, migrate from sandboxes to a Deploy app once the code - stabilizes. +- For long-lived services, migrate from a Deno Sandbox to a Deploy app once the + code stabilizes. diff --git a/sandboxes/expose_http.md b/sandbox/expose_http.md similarity index 96% rename from sandboxes/expose_http.md rename to sandbox/expose_http.md index 7c037bb79..e96cac785 100644 --- a/sandboxes/expose_http.md +++ b/sandbox/expose_http.md @@ -1,6 +1,6 @@ --- title: "Expose HTTP" -description: "Learn how to expose HTTP endpoints from Deno Sandboxes, enabling you to run web servers, APIs, and preview environments at the edge." +description: "Learn how to expose HTTP endpoints from Deno Sandbox, enabling you to run web servers, APIs, and preview environments at the edge." --- You can run dev servers, preview apps, webhook receivers, or framework CLIs on @@ -9,7 +9,7 @@ any port and publish them instantly to a secure, random HTTPS URL. ```tsx await sandbox.fs.writeTextFile( "server.js", - "Deno.serve(() => new Response('Hello from Sandboxes'));", + "Deno.serve(() => new Response('Hello from Deno Sandbox'));", ); const runtime = await sandbox.deno.run({ entrypoint: "server.js" }); const publicUrl = await sandbox.exposeHttp({ port: 8000 }); diff --git a/sandboxes/getting_started.md b/sandbox/getting_started.md similarity index 82% rename from sandboxes/getting_started.md rename to sandbox/getting_started.md index 6baa79ada..eec3ceefb 100644 --- a/sandboxes/getting_started.md +++ b/sandbox/getting_started.md @@ -1,21 +1,22 @@ --- title: "Getting started" -description: "Step-by-step walkthrough for enabling Sandboxes, creating your first microVM, running commands, exposing services, and managing secrets." +description: "Step-by-step walkthrough for enabling Deno Sandbox, creating your first microVM, running commands, exposing services, and managing secrets." --- -To use Sandboxes, you need a Deno Deploy account. If you do not have one yet you -can sign up for a free account at [console.deno.com](https://console.deno.com). +To use Deno Sandbox, you need a Deno Deploy account. If you do not have one yet +you can sign up for a free account at +[console.deno.com](https://console.deno.com). -## Access the Sandboxes dashboard +## Access the Deno Sandbox dashboard 1. Visit [console.deno.com](https://console.deno.com/) and sign in with your Deploy account. -2. Choose or create the organization where you want to run sandboxes. +2. Choose or create the organization where you want to run Deno Sandbox. 3. Open the **Sandboxes** tab to view existing sandboxes, lifetime usage, and access tokens. -Sandboxes and Deploy apps share the same organization boundary, so you can reuse -members, tokens, and observability settings across both products. +Deno Sandbox and Deno Deploy apps share the same organization boundary, so you +can reuse members, tokens, and observability settings across both products. ## Create an organization token @@ -27,7 +28,7 @@ and store it securely. Then export it in your local shell or CI job: export DENO_DEPLOY_TOKEN= ``` -![The Deno Deploy organization tokens screen.](/sandboxes/images/org-tokens.webp) +![The Deno Deploy organization tokens screen.](/sandbox/images/org-tokens.webp) :::tip Token security @@ -76,11 +77,11 @@ deno -EN main.ts Any sandbox you create will be listed in the **Sandboxes** tab of your Deno Deploy organization. -![The list of sandboxes created in the Deno Deploy console.](/sandboxes/images/sandbox-list.webp) +![The list of sandboxes created in the Deno Deploy console.](/sandbox/images/sandbox-list.webp) Details about the sandbox will be shown in its **Event log**. -![The sandbox event log details in the Deno Deploy console.](/sandboxes/images/sandbox-event-log.webp) +![The sandbox event log details in the Deno Deploy console.](/sandbox/images/sandbox-event-log.webp) ## Configuring your sandbox @@ -106,8 +107,8 @@ await using sandbox = await Sandbox.create({ ## Running commands and scripts -Sandboxes expose familiar filesystem and process APIs to run commands, upload -files, and spawn long-running services. +Deno Sandbox exposes familiar filesystem and process APIs to run commands, +upload files, and spawn long-running services. You can for example list files in the root directory: @@ -133,7 +134,7 @@ await proc.status; You can keep state between commands, stream stdout and stderr, or open an interactive REPL with `sandbox.deno.repl()` for agent-style workflows. -## Deploying from a sandbox +## Deploying from a Deno Sandbox The snippet below walks through an end-to-end workflow: it creates a Deploy app via the `Client`, boots a high-memory sandbox for heavier builds, scaffolds and @@ -177,6 +178,6 @@ for await (const log of build.logs()) { `await using` block ends). Call `sandbox.kill()` only if you need to tear the VM down ahead of that schedule. -Observability is shared with Deploy: every sandbox logs, trace, and metric is -visible in the Deno Deploy dashboard so you can debug agent runs the same way +Observability is shared with Deno Deploy: every sandbox logs, trace, and metric +is visible in the Deno Deploy dashboard so you can debug agent runs the same way you debug production apps. diff --git a/sandboxes/images/org-tokens.webp b/sandbox/images/org-tokens.webp similarity index 100% rename from sandboxes/images/org-tokens.webp rename to sandbox/images/org-tokens.webp diff --git a/sandboxes/images/sandbox-event-log.webp b/sandbox/images/sandbox-event-log.webp similarity index 100% rename from sandboxes/images/sandbox-event-log.webp rename to sandbox/images/sandbox-event-log.webp diff --git a/sandboxes/images/sandbox-list.webp b/sandbox/images/sandbox-list.webp similarity index 100% rename from sandboxes/images/sandbox-list.webp rename to sandbox/images/sandbox-list.webp diff --git a/sandboxes/index.md b/sandbox/index.md similarity index 76% rename from sandboxes/index.md rename to sandbox/index.md index cf8a35bc3..201844419 100644 --- a/sandboxes/index.md +++ b/sandbox/index.md @@ -1,16 +1,16 @@ --- -title: "Deno Sandboxes" -description: "Overview of the Sandboxes microVM platform on Deploy, including capabilities, security model, and ideal use cases." +title: "Deno Sandbox" +description: "Overview of the Deno Sandbox microVM platform on Deploy, including capabilities, security model, and ideal use cases." --- -Sandboxes bring instant Linux microVMs to Deno Deploy. Each sandbox boots in +Deno Sandbox brings instant Linux microVMs to Deno Deploy. Each sandbox boots in under a second, is API driven from the `@deno/sandbox` SDK, and is torn down as soon as you are done. The result is on-demand compute that feels like opening a terminal, yet ships with production-grade isolation and observability. -## What are Sandboxes? +## What is a Deno Sandbox? -- Linux microVMs orchestrated by Deno Deploy +- Individual Linux microVMs orchestrated by Deno Deploy - Designed for running untrusted code - Instantly available; boot times measured in milliseconds - Ephemeral by default but able to persist beyond the current connection @@ -20,7 +20,7 @@ terminal, yet ships with production-grade isolation and observability. ## Ideal use cases -Sandboxes specialize in workloads where code needs to be generated, evaluated, +Deno Sandbox specializes in workloads where code needs to be generated, evaluated, or safely executed on behalf of an untrusted user. They are ideal for: - AI agents and copilots that need to run code as they reason @@ -35,7 +35,7 @@ software. ## Run real workloads -Once the sandbox exists, you get a full Linux environment with files, processes, +Once the Deno Sandbox exists, you get a full Linux environment with files, processes, package managers, and background services: ```tsx @@ -44,7 +44,7 @@ await using sandbox = await Sandbox.create(); await sandbox.sh`ls -lh /`; ``` -## Security Policies +## Security policies Provision a sandbox so that it can only talk to approved hosts: @@ -72,28 +72,28 @@ await Sandbox.create({ ## Built for instant, safe compute Developers and AI systems now expect compute that is instant, safe, and globally -accessible. Sandboxes deliver: +accessible. Deno Sandbox delivers: - Instant spin-up with no warm pool to manage - Dedicated isolation with strict network egress policies -- Full observability alongside Deploy logs and traces +- Full observability alongside Deno Deploy logs and traces - Region selection, memory sizing, and lifetime controls per sandbox -- Seamless hand-off to Deploy apps when code is production ready +- Seamless hand-off to Deno Deploy apps when code is production ready -Together, Deno Deploy and Sandboxes form a single workflow: code is created, +Together, Deno Deploy and Deno Sandbox form a single workflow: code is created, proved safe in a sandbox, and deployed globally without new infrastructure or orchestration layers. ## Runtime support -The Sandboxes SDK is tested and supported on: +The Deno Sandbox SDK is tested and supported on: - **Deno:** Latest stable version - **Node.js:** Version 24+ -You can use Sandboxes from any environment that can import the `@deno/sandbox` -package and make outbound HTTPS requests to the Deploy API, meaning you can use -Sandboxes in your Node projects, Deno Deploy apps, or even browser-based tools. +You can use Deno Sandbox from any environment that can import the `@deno/sandbox` +package and make outbound HTTPS requests to the Deno Deploy API, meaning you can use +Deno Sandbox in your Node projects, Deno Deploy apps, or even browser-based tools. In your Deno projects you can use either the [jsr](https://jsr.io/@deno/sandbox) or [npm](https://www.npmjs.com/package/@deno/sandbox) package, however the jsr @@ -121,7 +121,7 @@ try { ## Limits -Sandboxes have the following limits: +Deno Sandbox has the following limits: - **Memory:** 768 MB to 4096 MB (1GB default) configurable per sandbox - **CPU:** 2 vCPU @@ -129,7 +129,7 @@ Sandboxes have the following limits: minutes - **Disk**: 10 GB of ephemeral storage - **Concurrency**: 5 concurrent sandboxes per organization (This is the default - concurrency limit during the pre-release phase of Sandboxes. Contact + concurrency limit during the pre-release phase of Deno Sandbox. Contact [deploy@deno.com](mailto:deploy@deno.com) to request a higher limit.) Exceeding these limits may result in throttling or termination of your sandbox. diff --git a/sandboxes/manage_apps.md b/sandbox/manage_apps.md similarity index 100% rename from sandboxes/manage_apps.md rename to sandbox/manage_apps.md diff --git a/sandboxes/promote.md b/sandbox/promote.md similarity index 87% rename from sandboxes/promote.md rename to sandbox/promote.md index b4837d3f9..334046460 100644 --- a/sandboxes/promote.md +++ b/sandbox/promote.md @@ -1,15 +1,15 @@ --- -title: "Promote Sandboxes to Deploy Apps" +title: "Promote Deno Sandbox to Deploy Apps" description: "Learn how to promote a sandbox to a full Deno Deploy app for production use." --- -There may be times when a sandbox proves a concept or prototype that should live -on as a first-class Deno Deploy app. Instead of rebuilding the codebase +There may be times when a Deno Sandbox proves a concept or prototype that should +live on as a first-class Deno Deploy app. Instead of rebuilding the codebase elsewhere, you can promote the sandbox directly using `sandbox.deno.deploy()`. ## Ephemeral compute vs Deploy apps -| Aspect | Sandboxes | Deploy Apps | +| Aspect | Deno Sandbox | Deno Deploy Apps | | ------------- | ---------------------------------------- | -------------------------------------- | | Lifetime | Seconds to minutes | Always-on, managed rollouts | | Control plane | Programmatic via SDK | Dashboard + CI/CD | diff --git a/sandboxes/security.md b/sandbox/security.md similarity index 92% rename from sandboxes/security.md rename to sandbox/security.md index 14dcd6336..dc52e5c88 100644 --- a/sandboxes/security.md +++ b/sandbox/security.md @@ -1,16 +1,16 @@ --- title: Security -description: "Understand the defense-in-depth model behind Deno Sandboxes: isolation, secrets, network controls, and auditing." +description: "Understand the defense-in-depth model behind Deno Sandbox: isolation, secrets, network controls, and auditing." --- -Sandboxes are designed for untrusted or AI-generated workloads. Every VM is +Deno Sandbox is designed for untrusted or AI-generated workloads. Every VM is ephemeral, isolated at the hypervisor level, and governed by strict outbound policies. This lets you run arbitrary code while keeping organization data and infrastructure safe. ## Secret redaction and substitution -Secrets never enter the sandbox environment variables. Instead, Deploy +Secrets never enter the sandbox environment variables. Instead, Deno Deploy substitutes them only when the sandbox makes outbound requests to an approved host. Configure secrets when creating a sandbox: @@ -42,7 +42,7 @@ allowing your automation to call third-party APIs securely. ## Outbound network control -By default, sandboxes have unrestricted outbound network access. Use the +By default, Deno Sandbox has unrestricted outbound network access. Use the `allowNet` option to restrict traffic to specific hosts: ```ts diff --git a/sandboxes/ssh.md b/sandbox/ssh.md similarity index 94% rename from sandboxes/ssh.md rename to sandbox/ssh.md index e493ec363..04a91de92 100644 --- a/sandboxes/ssh.md +++ b/sandbox/ssh.md @@ -3,8 +3,8 @@ title: "SSH" description: "How to open secure SSH access into a sandbox for interactive debugging, editor sessions, or long-running processes." --- -Sandboxes can hand out SSH credentials so you can inspect the filesystem, tail -logs, run editors, or forward ports. SSH access is available both in your +Deno Sandbox can hand out SSH credentials so you can inspect the filesystem, +tail logs, run editors, or forward ports. SSH access is available both in your terminal as a command and in the Deno Deploy Sandbox UI. ```tsx @@ -52,7 +52,7 @@ deno sandbox create -ssh After creating a sandbox, you can SSH into it in the Deno Deploy web app. 1. Log in to [console.deno.com](https://console.deno.com/) and navigate to the - "Sandboxes" section. + **Sandboxes** section. 2. Either create a new sandbox or select an existing one from the list. 3. Click **Start SSH terminal** to open an interactive terminal session in your browser. diff --git a/sandboxes/timeouts.md b/sandbox/timeouts.md similarity index 79% rename from sandboxes/timeouts.md rename to sandbox/timeouts.md index c09d31fd0..659174b46 100644 --- a/sandboxes/timeouts.md +++ b/sandbox/timeouts.md @@ -1,12 +1,13 @@ --- title: "Sandbox Timeouts" -description: "Understand how long sandboxes stay alive, how to extend or reconnect to them, and when to promote work to a Deploy app." +description: "Understand how long Deno Sandbox stays alive, how to extend or reconnect to them, and when to promote work to a Deno Deploy app." --- -Sandboxes are intentionally ephemeral. They boot in milliseconds, serve their -purpose, and disappear—reducing the blast radius of untrusted code and removing -infrastructure chores. Still, you can control exactly how long a sandbox stays -alive and even reconnect later when debugging is required. +Sandboxes created by Deno Sandbox are intentionally ephemeral. They boot in +milliseconds, serve their purpose, and disappear—reducing the blast radius of +untrusted code and removing infrastructure chores. Still, you can control +exactly how long a sandbox stays alive and even reconnect later when debugging +is required. ## Default timeout: `"session"` diff --git a/sandboxes/volumes.md b/sandbox/volumes.md similarity index 97% rename from sandboxes/volumes.md rename to sandbox/volumes.md index 24f709a40..23cf264ff 100644 --- a/sandboxes/volumes.md +++ b/sandbox/volumes.md @@ -1,6 +1,6 @@ --- title: "Persistent Volumes" -description: "Mount block storage into sandboxes to keep state between sessions" +description: "Mount block storage into Deno Sandbox to keep state between sessions" --- Persistent volumes let you attach regional block storage to a sandbox so data diff --git a/services/_data.ts b/services/_data.ts index 0b9c9ac60..165406da7 100644 --- a/services/_data.ts +++ b/services/_data.ts @@ -8,8 +8,8 @@ export const SidebarNav = [ href: "/deploy/", }, { - title: "Sandboxes", - href: "/sandboxes/", + title: "Sandbox", + href: "/sandbox/", }, { title: "Deploy Classic", diff --git a/subhosting/_data.ts b/subhosting/_data.ts index f074bd6fb..b6d6bbb94 100644 --- a/subhosting/_data.ts +++ b/subhosting/_data.ts @@ -53,8 +53,8 @@ export const SidebarNav = [ href: "/deploy/", }, { - title: "Sandboxes", - href: "/sandboxes/", + title: "Sandbox", + href: "/sandbox/", }, { title: "Deploy Classic", From 2b84cf87ad5301e762a23bf1b26f5ccbc8f4096b Mon Sep 17 00:00:00 2001 From: Jo Franchetti Date: Wed, 14 Jan 2026 14:46:50 +0000 Subject: [PATCH 2/7] fmt --- deploy/changelog.md | 3 ++- deploy/reference/runtime.md | 4 ++-- sandbox/cli.md | 4 ++-- sandbox/index.md | 16 +++++++++------- 4 files changed, 15 insertions(+), 12 deletions(-) diff --git a/deploy/changelog.md b/deploy/changelog.md index 03440de6b..bb6411d96 100644 --- a/deploy/changelog.md +++ b/deploy/changelog.md @@ -54,7 +54,8 @@ description: "Listing notable progress in the development and evolution of Deno - This is particularly useful for running third-party code, such as plugins, extensions, or user-generated or LLM-generated code, without risking the security of your application. - - We'll announce more details about Deno Sandbox in the new year, so stay tuned! + - We'll announce more details about Deno Sandbox in the new year, so stay + tuned! - Try it out from the "Sandbox" tab in the organization overview. - [Learn more about Deno Sandbox.](https://deno.com/deploy/sandbox) diff --git a/deploy/reference/runtime.md b/deploy/reference/runtime.md index 1bb96e16e..5f3452429 100644 --- a/deploy/reference/runtime.md +++ b/deploy/reference/runtime.md @@ -105,8 +105,8 @@ applications, and within a few hundred milliseconds for larger applications. Deno Deploy uses multiple optimizations to enable fast cold starts: -- Deno Sandbox and the Deno runtime are pre-provisioned to ensure they don't need - to be created from scratch when starting an application. +- Deno Sandbox and the Deno runtime are pre-provisioned to ensure they don't + need to be created from scratch when starting an application. - Applications start immediately when the client sends the first TCP packet to establish a TLS connection. For fast-starting applications, depending on the diff --git a/sandbox/cli.md b/sandbox/cli.md index ad4946403..a1e3a42af 100644 --- a/sandbox/cli.md +++ b/sandbox/cli.md @@ -7,8 +7,8 @@ The Deno CLI includes built-in commands for managing your Deno Sandbox instances, allowing you to create, control, and interact with them from your terminal. -This integration makes Deno Sandbox management feel natural within your existing Deno -workflow. +This integration makes Deno Sandbox management feel natural within your existing +Deno workflow. ## Creating your first Deno Sandbox diff --git a/sandbox/index.md b/sandbox/index.md index 201844419..af6310342 100644 --- a/sandbox/index.md +++ b/sandbox/index.md @@ -20,8 +20,9 @@ terminal, yet ships with production-grade isolation and observability. ## Ideal use cases -Deno Sandbox specializes in workloads where code needs to be generated, evaluated, -or safely executed on behalf of an untrusted user. They are ideal for: +Deno Sandbox specializes in workloads where code needs to be generated, +evaluated, or safely executed on behalf of an untrusted user. They are ideal +for: - AI agents and copilots that need to run code as they reason - Secure plugin or extension systems @@ -35,8 +36,8 @@ software. ## Run real workloads -Once the Deno Sandbox exists, you get a full Linux environment with files, processes, -package managers, and background services: +Once the Deno Sandbox exists, you get a full Linux environment with files, +processes, package managers, and background services: ```tsx import { Sandbox } from "@deno/sandbox"; @@ -91,9 +92,10 @@ The Deno Sandbox SDK is tested and supported on: - **Deno:** Latest stable version - **Node.js:** Version 24+ -You can use Deno Sandbox from any environment that can import the `@deno/sandbox` -package and make outbound HTTPS requests to the Deno Deploy API, meaning you can use -Deno Sandbox in your Node projects, Deno Deploy apps, or even browser-based tools. +You can use Deno Sandbox from any environment that can import the +`@deno/sandbox` package and make outbound HTTPS requests to the Deno Deploy API, +meaning you can use Deno Sandbox in your Node projects, Deno Deploy apps, or +even browser-based tools. In your Deno projects you can use either the [jsr](https://jsr.io/@deno/sandbox) or [npm](https://www.npmjs.com/package/@deno/sandbox) package, however the jsr From e2e3146c6df1b0daeb78e21f1bb6ece6aba71a6f Mon Sep 17 00:00:00 2001 From: Phil Hawksworth Date: Thu, 15 Jan 2026 10:10:14 +0000 Subject: [PATCH 3/7] Update _includes/layout.tsx --- _includes/layout.tsx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_includes/layout.tsx b/_includes/layout.tsx index ab4cc8007..7c68f122e 100644 --- a/_includes/layout.tsx +++ b/_includes/layout.tsx @@ -17,7 +17,7 @@ export default function Layout(data: Lume.Data) { return ( - + {deleteBackticks(data.title)} From 9c166bcb255470c2fd3afe15690379755a4f00ff Mon Sep 17 00:00:00 2001 From: Phil Hawksworth Date: Thu, 15 Jan 2026 10:12:40 +0000 Subject: [PATCH 4/7] Update _includes/sandbox-example.tsx --- _includes/sandbox-example.tsx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_includes/sandbox-example.tsx b/_includes/sandbox-example.tsx index 25ede6d72..4a88487ae 100644 --- a/_includes/sandbox-example.tsx +++ b/_includes/sandbox-example.tsx @@ -13,8 +13,8 @@ export default function Raw(data: Lume.Data) { {data.children}

- For more information about Sandbox, see the{" "} - Sandbox documentation. + For more information, see the{" "} + Deno Sandbox documentation.

); From d07e828a22fba1dab9718a6a543842ee43def3ec Mon Sep 17 00:00:00 2001 From: Phil Hawksworth Date: Thu, 15 Jan 2026 10:14:31 +0000 Subject: [PATCH 5/7] Update deploy/changelog.md --- deploy/changelog.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy/changelog.md b/deploy/changelog.md index bb6411d96..9170abb6a 100644 --- a/deploy/changelog.md +++ b/deploy/changelog.md @@ -56,7 +56,7 @@ description: "Listing notable progress in the development and evolution of Deno security of your application. - We'll announce more details about Deno Sandbox in the new year, so stay tuned! - - Try it out from the "Sandbox" tab in the organization overview. + - Try it out from the "Sandboxes" tab in the Deno Deploy console - [Learn more about Deno Sandbox.](https://deno.com/deploy/sandbox) ### Bug fixes From 9e550ef26bb186293cc0d85d4d9e102f47a3d84e Mon Sep 17 00:00:00 2001 From: Phil Hawksworth Date: Thu, 15 Jan 2026 10:21:01 +0000 Subject: [PATCH 6/7] Update runtime/reference/cli/deploy.md --- runtime/reference/cli/deploy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/runtime/reference/cli/deploy.md b/runtime/reference/cli/deploy.md index 30439d5f0..127a1f23c 100644 --- a/runtime/reference/cli/deploy.md +++ b/runtime/reference/cli/deploy.md @@ -151,7 +151,7 @@ deno deploy logs deno deploy logs --org my-org --app my-app --start "2024-01-01T00:00:00Z" ``` -### Deno Sandbox management +### Sandbox management Interact with running sandboxes directly from the Deploy CLI. From 06cc650dc9f679a9bfc774ad86aa03fca7a877fd Mon Sep 17 00:00:00 2001 From: Jo Franchetti Date: Mon, 19 Jan 2026 16:44:14 +0000 Subject: [PATCH 7/7] Update deploy/reference/runtime.md Co-authored-by: Luca Casonato --- deploy/reference/runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy/reference/runtime.md b/deploy/reference/runtime.md index 5f3452429..f5d2616d4 100644 --- a/deploy/reference/runtime.md +++ b/deploy/reference/runtime.md @@ -105,7 +105,7 @@ applications, and within a few hundred milliseconds for larger applications. Deno Deploy uses multiple optimizations to enable fast cold starts: -- Deno Sandbox and the Deno runtime are pre-provisioned to ensure they don't +- Linux microVMs and the Deno runtime are pre-provisioned to ensure they don't need to be created from scratch when starting an application. - Applications start immediately when the client sends the first TCP packet to