diff --git a/runtime/getting_started/installation.md b/runtime/getting_started/installation.md index af22f293d..298bbb6f6 100644 --- a/runtime/getting_started/installation.md +++ b/runtime/getting_started/installation.md @@ -16,7 +16,11 @@ Linux, only x64 is supported. ## Download and install [deno_install](https://github.com/denoland/deno_install) provides convenience -scripts to download and install the binary. +scripts to download and install the binary. The shell and PowerShell install +scripts place the `deno` executable in `$HOME/.deno/bin` (or `$Home\.deno\bin` +on Windows) by default — see +[Customizing the install directory](#customizing-the-install-directory) below to +install Deno somewhere else. @@ -188,6 +192,32 @@ vfox use --global deno +### Customizing the install directory + +By default the shell and PowerShell install scripts install Deno to +`$HOME/.deno/bin`. Set the `DENO_INSTALL` environment variable before running +the script to install to a different location — the binary is then placed in +`$DENO_INSTALL/bin`. + +On macOS and Linux, set `DENO_INSTALL` when invoking the piped shell so the +installer (not just `curl`) sees the variable: + +```shell +curl -fsSL https://deno.land/install.sh | DENO_INSTALL=/opt/deno sh +``` + +On Windows, set `$env:DENO_INSTALL` before running the PowerShell installer: + +```powershell +$env:DENO_INSTALL = "C:\deno" +irm https://deno.land/install.ps1 | iex +``` + +Remember to add the new `bin` directory to your `PATH` so the `deno` command is +available in your shell. See the +[`deno_install` README](https://github.com/denoland/deno_install) for the +canonical behavior and other supported options. + You can also build and install from source using [Cargo](https://crates.io/crates/deno): @@ -226,9 +256,9 @@ your `PATH` yet. To fix this: - Confirm the install directory is on your `PATH`. The shell install script defaults to `~/.deno/bin` on macOS and Linux; for npm-based installs, run `npm config get prefix` to find the directory containing the global `bin`. -- If you customised the install location, the shell install script's install - root can be overridden with the `DENO_INSTALL` environment variable, in which - case the binary lives at `$DENO_INSTALL/bin/deno`. +- If you customised the install location, the binary lives at + `$DENO_INSTALL/bin/deno` — see + [Customizing the install directory](#customizing-the-install-directory). ## Updating