deno_install/README.md

108 lines
3.2 KiB
Markdown

# deno_install
**One-line commands to install Deno on your system.**
| **Linux & Mac** | **Windows** |
|:---------------:|:-----------:|
| [![Build Status](https://travis-ci.com/denoland/deno_install.svg?branch=master)](https://travis-ci.com/denoland/deno_install) | [![Build status](https://ci.appveyor.com/api/projects/status/gtekeaf7r60xa896?branch=master&svg=true)](https://ci.appveyor.com/project/deno/deno-install) |
## Install Latest Version
**With Shell:**
```sh
curl -fsSL https://deno.land/x/install/install.sh | sh
```
**With PowerShell:**
```powershell
iwr https://deno.land/x/install/install.ps1 -useb | iex
```
## Install Specific Version
**With Shell:**
```sh
curl -fsSL https://deno.land/x/install/install.sh | sh -s v0.2.10
```
**With PowerShell:**
```powershell
iwr https://deno.land/x/install/install.ps1 -useb -outf install.ps1; .\install.ps1 v0.2.10
```
## Install via Package Manager
**With [Scoop](https://scoop.sh):**
```powershell
scoop install deno
```
**With [Homebrew](https://brew.sh/):**
```sh
brew install deno
```
## Install and Manage Multiple Versions
**With [asdf](https://asdf-vm.com) and [asdf-deno](https://github.com/asdf-community/asdf-deno):**
```sh
asdf plugin-add deno https://github.com/asdf-community/asdf-deno.git
asdf install deno 0.2.10
# Activate globally with:
asdf global deno 0.2.10
# Activate locally in the current folder with:
asdf local deno 0.2.10
```
## Environment Variables
- `DENO_INSTALL` - The directory in which to install Deno. This defaults to `$HOME/.deno`.
One application of this is a system-wide Shell installation to [`/opt/deno`](https://refspecs.linuxfoundation.org/FHS_3.0/fhs/ch03s13.html):
```sh
curl -fsSL https://deno.land/x/install/install.sh | DENO_INSTALL=/opt/deno sh -s v0.2.10
```
Not yet supported in the PowerShell installer (#76).
## Compatibility
- The Shell installer can be used on Windows via the [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/about).
- The PowerShell installer can be used on Linux and Mac thanks to [PowerShell Core](https://docs.microsoft.com/en-us/powershell/scripting).
## Known Issues
### Running scripts is disabled
```
PS C:\> iwr https://deno.land/x/install/install.ps1 -useb -outf install.ps1; .\install.ps1 v0.2.10
.\install.ps1 : File C:\install.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.
At line:1 char:71
+ ... /x/install/install.ps1 -useb -outf install.ps1; .\install.ps1 v0.2.10
+ ~~~~~~~~~~~~~
+ CategoryInfo : SecurityError: (:) [], ParentContainsErrorRecordException
+ FullyQualifiedErrorId : UnauthorizedAccess
```
**When does this issue occur?**
If your systems' [ExecutionPolicy](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies) is `Undefined` or `Restricted`.
**How can this issue be fixed?**
Allow scripts that are downloaded from the internet to be executed by setting the execution policy to `RemoteSigned`:
```powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
```