From 50bc4c5d9ca4700786e201c9391fee1b2900b400 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bartek=20Iwa=C5=84czuk?= Date: Thu, 18 Jun 2026 15:07:15 +0200 Subject: [PATCH] docs: clarify that Deno runtime flags can't be passed on Deploy --- deploy/reference/builds.md | 15 ++++++++++----- deploy/reference/runtime.md | 5 +++-- 2 files changed, 13 insertions(+), 7 deletions(-) diff --git a/deploy/reference/builds.md b/deploy/reference/builds.md index ec51097cc..32b90e351 100644 --- a/deploy/reference/builds.md +++ b/deploy/reference/builds.md @@ -1,5 +1,5 @@ --- -last_modified: 2026-02-25 +last_modified: 2026-06-18 title: Builds description: "Detailed explanation of the build process in Deno Deploy, covering build triggers, stages, configuration options, caching, and the build environment." --- @@ -109,8 +109,11 @@ repository if you're using a recognized framework or common build setup. - **Dynamic**: For applications that respond to requests using a server (API servers, server-rendered websites, etc.) - **Entrypoint**: The JavaScript or TypeScript file to execute - - **Arguments** (optional): Command-line arguments to pass to the - application + - **Arguments** (optional): Command-line arguments passed to the + application, after the entrypoint. These are not flags for the Deno + runtime: runtime flags such as `--unstable-*` cannot be passed, since the + runtime always runs with a fixed set of flags. See the + [runtime reference](/deploy/reference/runtime/) for details. - **Runtime working directory** (optional): The working directory for the application at runtime - **Runtime memory limit** (optional): The maximum amount of memory the @@ -157,8 +160,10 @@ the entire configuration will be sourced from the file instead of the dashboard - `deploy.runtime.type`: Must be set to `"dynamic"`, or omitted (dynamic is the default). - `deploy.runtime.entrypoint`: The JavaScript or TypeScript file to execute. - - `deploy.runtime.args` (optional): Command-line arguments to pass to the - application. + - `deploy.runtime.args` (optional): Command-line arguments passed to the + application, after the entrypoint. These are not flags for the Deno + runtime; runtime flags such as `--unstable-*` cannot be passed. See the + [runtime reference](/deploy/reference/runtime/). - `deploy.runtime.cwd` (optional): The working directory for the application at runtime. - `deploy.runtime.memory_limit` (optional): The maximum amount of memory the diff --git a/deploy/reference/runtime.md b/deploy/reference/runtime.md index 33fd82f59..65f5e4d33 100644 --- a/deploy/reference/runtime.md +++ b/deploy/reference/runtime.md @@ -1,5 +1,5 @@ --- -last_modified: 2026-01-20 +last_modified: 2026-06-18 title: Runtime description: "Details about the Deno Deploy runtime environment, including application lifecycle, startup, shutdown, and cold start optimization." --- @@ -14,7 +14,8 @@ spawning subprocesses, and loading FFI and node native addons. The Deno runtime runs using `--allow-all` permissions. -Custom flags cannot be passed to the Deno runtime. +Custom flags, including `--unstable-*` flags, cannot be passed to the Deno +runtime. ## Runtime environment