1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-12-25 08:39:09 -05:00
denoland-deno/docs/getting_started/installation.md

92 lines
2.2 KiB
Markdown
Raw Normal View History

2020-05-06 18:21:13 -04:00
## Installation
Deno works on macOS, Linux, and Windows. Deno is a single binary executable. It
has no external dependencies.
### Download and install
[deno_install](https://github.com/denoland/deno_install) provides convenience
scripts to download and install the binary.
Using Shell (macOS and Linux):
```shell
curl -fsSL https://deno.land/x/install/install.sh | sh
```
Using PowerShell (Windows):
```shell
iwr https://deno.land/x/install/install.ps1 -useb | iex
```
Using [Scoop](https://scoop.sh/) (Windows):
```shell
scoop install deno
```
Using [Chocolatey](https://chocolatey.org/packages/deno) (Windows):
```shell
choco install deno
```
Using [Homebrew](https://formulae.brew.sh/formula/deno) (macOS):
```shell
brew install deno
```
Using [Nix](https://nixos.org/download.html) (macOS and Linux):
```shell
nix-shell -p deno
```
Build and install from source using [Cargo](https://crates.io/crates/deno):
2020-05-06 18:21:13 -04:00
```shell
cargo install deno --locked
2020-05-06 18:21:13 -04:00
```
Deno binaries can also be installed manually, by downloading a zip file at
[github.com/denoland/deno/releases](https://github.com/denoland/deno/releases).
These packages contain just a single executable file. You will have to set the
executable bit on macOS and Linux.
2021-04-21 05:24:42 -04:00
Official Docker images are not available at the current time
([issue#3356](https://github.com/denoland/deno/issues/3356)), but
[community images](https://github.com/hayd/deno-docker) are available.
2020-05-06 18:21:13 -04:00
### Testing your installation
To test your installation, run `deno --version`. If this prints the Deno version
to the console the installation was successful.
2020-06-08 09:49:32 -04:00
Use `deno help` to see help text documenting Deno's flags and usage. Get a
detailed guide on the CLI [here](./command_line_interface.md).
2020-05-06 18:21:13 -04:00
### Updating
To update a previously installed version of Deno, you can run:
```shell
deno upgrade
```
2020-05-06 18:21:13 -04:00
This will fetch the latest release from
[github.com/denoland/deno/releases](https://github.com/denoland/deno/releases),
unzip it, and replace your current executable with it.
You can also use this utility to install a specific version of Deno:
```shell
deno upgrade --version 1.0.1
```
2020-05-06 18:21:13 -04:00
### Building from source
Information about how to build from source can be found in the `Contributing`
chapter.