1. Docs
  2. Get Started
  3. Download and Install

Download and Install

This page contains detailed instructions for installing Pulumi on your machine. For links to detailed release notes, see the Available Versions page.

Install Pulumi

macOS Linux Windows

Homebrew

macOS Sierra (10.12) or later is required.

You can install Pulumi through the Homebrew package manager:

$ brew install pulumi

This will install the pulumi CLI to the usual place (often /usr/local/bin/pulumi) and add it to your path.

Subsequent updates can be installed in the usual way:

$ brew upgrade pulumi

Installation Script

Alternatively, you can run our installation script.

$ curl -fsSL https://get.pulumi.com | sh

This will install the pulumi CLI to ~/.pulumi/bin and add it to your path. When it can’t automatically add pulumi to your path, you will be prompted to add it manually. See How to permanently set $PATH on Unix for guidance.

The installer script can be rerun to subsequently install new updates.

Manual Installation

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

  1. Download Pulumi 1.9.0 for macOS. For prior versions and release notes, see the Available Versions page.

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

Installation Script

To install, run our installation script:

$ curl -fsSL https://get.pulumi.com | sh

This will install the pulumi CLI to ~/.pulumi/bin and add it to your path. When it can’t automatically add pulumi to your path, you will be prompted to add it manually. See How to permanently set $PATH on Unix for guidance.

Manual Installation

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

  1. Download Pulumi 1.9.0 for Linux x64. For prior versions and release notes, see the Available Versions page.

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

Installation Script

Windows 8 and 10 are supported.

To install, run our installation script from a cmd.exe window:

@"%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/install.ps1'))" && SET "PATH=%PATH%;%USERPROFILE%\.pulumi\bin"

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

Chocolatey

You can install Pulumi through the Chocolatey package manager:

choco install pulumi

This will install the pulumi CLI to the usual place (often $($env:ChocolateyInstall)\lib\pulumi), will generate shims (usually $($env:ChocolateyInstall)\bin) that is added to your path.

Subsequent updates can be installed in the usual way:

choco upgrade pulumi

Manual Installation

Alternatively, you can install Pulumi manually.

  1. Download Pulumi 1.9.0 for Windows x64. For prior versions and release notes, see the Available Versions page.

  2. Unzip the file and extract the contents to a folder such as C:\pulumi.

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

Verify your Installation

After installing Pulumi, verify everything is in working order by running the pulumi CLI:

$ pulumi version
v1.9.0

Pulumi Not Found Error

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

New Version Warning

If a new version of Pulumi is available, the CLI produces the following example warning when running any of the available commands:

warning: A new version of Pulumi is available. To upgrade from version '0.17.26' to '1.9.0', run
   $ curl -sSL https://get.pulumi.com | sh

or visit https://pulumi.com/docs/install/ for manual instructions and release notes.

Uninstall Pulumi

To uninstall Pulumi, remove the .pulumi folder from your home directory. If you installed Pulumi manually, you should also remove the pulumi folder that was created.