W3cubDocs

/Deno 2

deno upgrade

Command line usage:
deno upgrade [OPTIONS] [VERSION]...

Upgrade deno executable to the given version.

Latest

deno upgrade

Specific version

deno upgrade 1.45.0
deno upgrade 1.46.0-rc.1
deno upgrade 9bc2dd29ad6ba334fd57a20114e367d3c04763d4

Channel

deno upgrade stable
deno upgrade rc
deno upgrade canary

The version is downloaded from https://dl.deno.land and is used to replace the current executable.

If you want to not replace the current Deno executable but instead download an update to a different location, use the --output flag:

deno upgrade --output $HOME/my_deno

Upgrade options

--dry-run

Perform all checks without replacing old exe.

--force

Short flag: -f

Replace current exe even if not out-of-date.

--output

The path to output the updated version to.

Options

--cert

Load certificate authority from PEM encoded file.

Examples

Upgrade to the latest version

Use this command without any options to upgrade Deno to the latest available version:

$ deno upgrade
Checking for latest version
Version has been found
Deno is upgrading to version 1.38.5
downloading https://github.com/denoland/deno/releases/download/v1.38.5/deno-x86_64-apple-darwin.zip
downloading 100%
Upgrade done successfully

Upgrade to a specific version

You can specify a particular version to upgrade to:

$ deno upgrade --version 1.37.0
Checking for version 1.37.0
Version has been found
Deno is upgrading to version 1.37.0
downloading https://github.com/denoland/deno/releases/download/v1.37.0/deno-x86_64-apple-darwin.zip
downloading 100%
Upgrade done successfully

Check available upgrade without installing

Use the --dry-run flag to see what would be upgraded without actually performing the upgrade:

$ deno upgrade --dry-run
Checking for latest version
Version has been found
Would upgrade to version 1.38.5

--quiet flag

The --quiet flag suppresses diagnostic output during the upgrade process. When used with deno upgrade, it will hide progress indicators, download information, and success messages.

$ deno upgrade --quiet

This is useful for scripting environments or when you want cleaner output in CI pipelines.

Canary build

By default, Deno will upgrade from the official GitHub releases. You can specify the --canary build flag for the latest canary build:

# Upgrade to the latest canary build
$ deno upgrade --canary

© 2018–2025 the Deno authors
Licensed under the MIT License.
https://docs.deno.com/runtime/reference/cli/upgrade