English | 简体中文

Installation

You can install it using the installers below, or download a release binary from the releases page.

With Shell:

curl -fsSL https://dvm.deno.dev | sh

With PowerShell:

irm https://dvm.deno.dev | iex

Usage

➜  ~  dvm --help
Deno Version Manager - Easy way to manage multiple active deno versions.
Usage: dvm.exe <COMMAND>
Commands:   completions  Generate shell completions   info         Show dvm info.   install      Install deno executable to the given version. [aliases: i, add]   list         List all installed versions [aliases: ls, ll, la]   list-remote  List all released versions [aliases: lr, ls-remote]   uninstall    Uninstall a given version [aliases: un, unlink, rm, remove]   use          Use a given version or a semver range or a alias to the range.   alias        Set or unset an alias   activate     Activate Dvm   deactivate   Deactivate Dvm   doctor       Fixing dvm specific environment variables and other issues   upgrade      Upgrade aliases to the latest version, use self to upgrade dvm itself   exec         Execute deno command with a specific deno version   clean        Clean dvm cache   registry     Change registry that dvm fetch from   update       Update remove version list local cache to the latest   help         Print this message or the help of the given subcommand(s)
Options:   -h, --help     Print help information   -V, --version  Print version information
EXAMPLE:   dvm install 1.3.2     Install v1.3.2 release   dvm install           Install the latest available version   dvm install lts       Install the latest LTS version   dvm use 1.0.0         Use v1.0.0 release   dvm use latest        Use the latest alias that comes with dvm, equivalent to *   dvm use lts           Use the latest LTS version   dvm use canary        Use the canary version of the Deno
NOTE:   To remove, delete, or uninstall dvm - just remove the $DVM_DIR folder (usually ~/.dvm)

Verify installation

To verify that dvm has been installed, do:

dvm -V

which should output dvm's version if the installation was successful.

Initialisation

Calling dvm will creates an ~/.dvm/ directory if it doesn't exist, and all installed versions of deno will put into ~/.dvm.

➜  ~  dvm
Creating /Users/justjavac/.dvm

.dvmrc

You can let dvm to writing config to current directery by add the --local flag to dvm use. Afterwards, dvm use, dvm install will use the version specified in the .dvmrc file if no version is supplied on the command line.

For example, to make dvm default to the 1.17.0 release for the current directory:

dvm use --local 1.17.0

Then when someone else with a copy of your project and run dvm:

$ dvm use
No version input detect, try to use version in .dvmrc file
Using semver range: 1.17.0
Writing to home folder config
Now using deno 1.17.0

Example

Listing versions

List all installed versions:

➜  ~  dvm list
 * 0.1.0
   0.1.1
   0.1.2

The version with a asterisk(*) means that this version is the version currently in use.

Switching version

➜  ~  dvm use 1.1.0
now use deno 1.1.0
➜  ~  dvm use 1.2.0
deno v1.2.0 is not installed. Use dvm install 1.2.0 to install it first.

Compatibility

• The Shell installer can be used on Windows with

Caveats

unzip is required

The program unzip is a requirement for the Shell installer.

$ curl -fsSL https://deno.land/x/dvm/install.sh | sh
Error: unzip is required to install dvm (see: https://github.com/justjavac/dvm#unzip-is-required).

When does this issue occur?

During the install.sh process, unzip is used to extract the zip archive.

How can this issue be fixed?

You can install unzip via brew install unzip on MacOS or apt-get install unzip -y on Linux(Ubuntu,Debian,Deepin).

Powershell on Windows is required

Currently, we use PowerShell profile to set environment variables due to various reasons, so it's required.

License

Deno Version Manager(dvm) is released under the MIT License. See the bundled LICENSE file for details.