---
title: Download & Install
url: /docs/esc/cli/download-install/
---
## Select an Operating System

<!-- chooser: os -->

<!-- option: macos -->
<h3 class="no-anchor pt-4">
<svg xmlns="http://www.w3.org/2000/svg" class="ph-icon ph-icon--regular pr-2" fill="currentColor" aria-hidden="true" focusable="false"><use href="/icons/sprite.81a77c0e2e8c31ce27a65187fc9476e671ceed65d5af35c8daf4b722cc48469f.svg#p-package-regular"/></svg>
Homebrew Package Manager</h3>
```bash
$ brew update && brew install pulumi/tap/esc
```

<h3 class="no-anchor pt-4">
<svg xmlns="http://www.w3.org/2000/svg" class="ph-icon ph-icon--regular pr-2" fill="currentColor" aria-hidden="true" focusable="false"><use href="/icons/sprite.81a77c0e2e8c31ce27a65187fc9476e671ceed65d5af35c8daf4b722cc48469f.svg#p-download-simple-regular"/></svg>
macOS Binary Download</h3>
[amd64](https://get.pulumi.com/esc/releases/esc-v0.24.0-darwin-x64.tar.gz)
[arm64](https://get.pulumi.com/esc/releases/esc-v0.24.0-darwin-arm64.tar.gz)
macOS Ventura (13) or later is required.
The latest version of Pulumi ESC is 0.24.0.

**Note:** For a streamlined Pulumi ESC walkthrough, including language runtime installation and cloud configuration, see the [Get Started](/docs/esc/get-started/) guide.

<!-- /option -->

<!-- option: linux -->

<h3 class="no-anchor pt-4">
<svg xmlns="http://www.w3.org/2000/svg" class="ph-icon ph-icon--regular pr-2" fill="currentColor" aria-hidden="true" focusable="false"><use href="/icons/sprite.81a77c0e2e8c31ce27a65187fc9476e671ceed65d5af35c8daf4b722cc48469f.svg#p-package-regular"/></svg>
Install Script</h3>
```bash
$ curl -fsSL https://get.pulumi.com/esc/install.sh | sh
```

<h3 class="no-anchor pt-4">
<svg xmlns="http://www.w3.org/2000/svg" class="ph-icon ph-icon--regular pr-2" fill="currentColor" aria-hidden="true" focusable="false"><use href="/icons/sprite.81a77c0e2e8c31ce27a65187fc9476e671ceed65d5af35c8daf4b722cc48469f.svg#p-download-simple-regular"/></svg>
Linux Binary Download</h3>
[amd64](https://get.pulumi.com/esc/releases/esc-v0.24.0-linux-x64.tar.gz)

The latest version of Pulumi ESC is 0.24.0.

**Note:** For a streamlined Pulumi ESC walkthrough, including language runtime installation and cloud configuration, see the [Get Started](/docs/esc/get-started/) guide.

<!-- /option -->

<!-- option: windows -->

<h3 class="no-anchor pt-4">
<svg xmlns="http://www.w3.org/2000/svg" class="ph-icon ph-icon--regular pr-2" fill="currentColor" aria-hidden="true" focusable="false"><use href="/icons/sprite.81a77c0e2e8c31ce27a65187fc9476e671ceed65d5af35c8daf4b722cc48469f.svg#p-download-simple-regular"/></svg>
Windows Binary Download</h3>

[amd64](https://get.pulumi.com/esc/releases/esc-v0.24.0-windows-x64.zip)

Windows 8 and later are supported.
The latest version of Pulumi ESC is 0.24.0. For older versions, see [Available Versions](/docs/install/versions/).

**Note:** For a streamlined Pulumi ESC walkthrough, including language runtime installation and cloud configuration, see the [Get Started](/docs/esc/get-started/) guide.

<!-- /option -->

<!-- /chooser -->

### Other installation methods

In addition, there are many ways to install Pulumi ESC:

<!-- chooser: os -->

<!-- option: macos -->

##### Official Pulumi Homebrew Tap

You can install Pulumi ESC through the [Homebrew package manager](https://brew.sh/) and using our official
[Pulumi Homebrew Tap](https://github.com/pulumi/homebrew-tap/)
```bash
$ brew update && brew install pulumi/tap/esc
```

This will install the `esc` CLI to the usual place (often `/usr/local/bin/esc`) and add it to your path.
Subsequent updates can be installed in the usual way:
```bash
$ brew upgrade esc
```

##### Community Homebrew

A Pulumi formula is available on the Community Homebrew. If you do not have the Pulumi tap installed, then you can
still install Pulumi ESC from homebrew using the command:
```bash
$ brew install esc
```

##### macOs Installation Script

To install, run our installation script:
```bash
$ curl -fsSL https://get.pulumi.com/esc/install.sh | sh
```

This will install the `esc` CLI to `~/.pulumi/bin` and add it to your path. When it can’t automatically add `esc` to your path, you will be prompted to add it manually.
See [How to permanently set $PATH on Unix](https://stackoverflow.com/questions/14637979/how-to-permanently-set-path-on-linux-unix) for guidance.
The installer script can be rerun to subsequently install new updates.

##### macOS Manual Installation

If you do not wish to use the previous options, you can install Pulumi manually.

Download [Pulumi ESC 0.24.0 for macOS](https://get.pulumi.com/esc/releases/esc-v0.24.0-darwin-x64.tar.gz).

Extract the tarball and move the binaries in the `esc` directory to a directory included in your system’s `$PATH`.

<!-- /option -->

<!-- option: linux -->

##### Linux Installation Script

To install, run our installation script:
```bash
$ curl -fsSL https://get.pulumi.com/esc/install.sh | sh
```

This will install the `esc` CLI to `~/.pulumi/bin` and add it to your path. When it can’t automatically add `esc` to your path, you will be prompted to add it manually.
See [How to permanently set $PATH on Unix](https://stackoverflow.com/questions/14637979/how-to-permanently-set-path-on-linux-unix) for guidance.

##### Linux Manual Installation

Alternatively, you can install Pulumi ESC manually. We provide a prebuilt binary for Linux.

Download [Pulumi ESC 0.24.0 for Linux x64](https://get.pulumi.com/esc/releases/esc-v0.24.0-linux-x64.tar.gz).

Extract the tarball and move the binaries in the `esc` directory to a directory included in your system’s `$PATH`.

<!-- /option -->

<!-- option: windows -->

##### Windows Installation Script

Open a new command prompt window (**WIN+R**: `cmd.exe`):

Run our installation script:

```bash
> @"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; iex ((New-Object System.Net.WebClient).DownloadString('https://get.pulumi.com/esc/install.ps1'))" && SET "PATH=%PATH%;%USERPROFILE%\.pulumi\bin"
```

This will install the `esc.exe` CLI to `%USERPROFILE%\.pulumi\bin` and add it to your path.

##### Windows Manual Installation

Alternatively, you can install Pulumi ESC manually using binaries built for Windows x64.

Download [Pulumi ESC 0.24.0 binaries for Windows x64](https://get.pulumi.com/esc/releases/esc-v0.24.0-windows-x64.zip). For prior versions and release notes, see the [Available Versions](/docs/install/versions/) page.

Unzip the file and extract the contents to a folder such as `C:\esc`.

Add `C:\esc\bin` to your path via **System Properties** -> **Advanced** -> **Environment Variables** -> **User Variables** -> **Path** -> **Edit**.

<!-- /option -->

<!-- /chooser -->

## Verify installation

After installing Pulumi ESC, verify everything is in working order by running the `esc` CLI:

<!-- chooser: os -->

<!-- option: macos -->
```bash
$ esc version
```

<!-- /option -->

<!-- option: linux -->
```bash
$ esc version
```

<!-- /option -->

<!-- option: windows -->
```bash
> esc version
```

<!-- /option -->

<!-- /chooser -->

### Common errors and warnings

These are common installation-related errors or warnings you may encounter.

#### Pulumi ESC not found error

If you get an error that `esc` could not be found, it means your path has not been configured correctly. Verify that your system's `$PATH` contains the directory containing the `esc` CLI installed earlier.

## Uninstalling Pulumi ESC

To uninstall Pulumi ESC, use your installation method's command of choice. If you installed Pulumi ESC manually, delete the `esc` directory that you created. Afterwards, remove the `.pulumi` folder from your home directory which contains plugins and other cached metadata.