Skip to content

docs(cli): document --build-timeout unit suffixes and deno.json precedence #3484

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
piscisaureus merged 3 commits into from
Oct 1, 2026
Merged

docs(cli): document --build-timeout unit suffixes and deno.json precedence #3484

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ec812ab
docs(cli): document --build-timeout unit suffixes and deno.json prece…
piscisaureus Oct 1, 2026
d480877
docs(cli): don't overstate the create warning; mention deno.jsonc
piscisaureus Oct 1, 2026
76c91cc
docs(cli): narrow the deno.json precedence note
piscisaureus Oct 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 10 additions & 4 deletions runtime/reference/cli/deploy.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified: 2026-02-12
last_modified: 2026-10-01
title: "deno deploy"
command: deploy
openGraphLayout: "/open_graph/cli-commands.jsx"
Expand Down Expand Up @@ -68,6 +68,11 @@ These flags control where the app code comes from:

#### Build configuration options

If the app directory's `deno.json` or `deno.jsonc` sets build configuration in
its `deploy` section, that takes precedence over the corresponding options on
every deploy. See
[editing app configuration from source code](/deploy/reference/builds/#editing-app-configuration-from-source-code).

- `--app-directory <path>` - Path to the app directory within the project
- `--framework-preset <preset>` - Use a framework preset for build defaults.
Supported values: `astro`, `nextjs`, `nuxt`, `remix`, `solidstart`,
Expand Down Expand Up @@ -99,8 +104,8 @@ These flags control where the app code comes from:

#### Build resource options

- `--build-timeout <minutes>` - Build timeout. Allowed values: `5`, `10`, `15`,
`20`, `25`, `30`
- `--build-timeout <duration>` - Build timeout, in minutes or with a unit suffix
(e.g. `10`, `10m` or `600s`). Allowed values: 5, 10, 15, 20, 25 or 30 minutes
- `--build-memory-limit <megabytes>` - Build memory limit in MB. Allowed values:
`1024`, `2048`, `3072`, `4096`
- `--region <region>` - Deployment region. Allowed values: `us`, `eu`, `global`
Expand All @@ -119,7 +124,8 @@ you through each configuration step:
6. **Build configuration** - Auto-detects framework settings. You can accept the
detected config or configure manually (framework preset, install/build
commands, runtime mode, etc.)
7. **Build timeout** - How long the build can run
7. **Build timeout** - How long the build can run (skipped when you accept a
build configuration detected from `deno.json` or `deno.jsonc`)
8. **Build memory limit** - How much memory the build gets
9. **Region** - Where to deploy (`us`, `eu`, or `global`)
10. **Confirm** - Review and confirm before creating
Expand Down
Loading