Fork me on GitHub

Installation

First thing’s first, let’s install the Pulumi CLI on your machine.

Please select your operating system.

After installation, or if you’ve already installed Pulumi, let’s choose a cloud to get started.

macOS

To install Pulumi, 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.

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

(Alternative) Homebrew

If you prefer, 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

Linux

To install on Linux, 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.

If you prefer to download and manually install the tarball, please select “Manual Install” in the above dropdown.

Windows

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

@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "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.

Alternatives

Raw binaries are available for all major operating systems if you prefer to install them manually.

macOS Binaries

macOS Sierra (10.12) or later is required.

  1. Download Pulumi 0.15.2 for macOS.

  2. Unzip the tarball and run the install script. After installation, you may delete the extracted folder.

     $ tar -xzf pulumi-v0.15.2-darwin-x64.tar.gz
     $ ./pulumi/install.sh
    
  3. Add /usr/local/pulumi/bin to your path:

     echo "export PATH=\$PATH:/usr/local/pulumi/bin" >> ~/.profile
    

Linux Binaries

We provide a pre-built binary for Linux.

  1. Download Pulumi 0.15.2 for Linux x64.

  2. Unzip the tarball and run the install script. After installation, you may delete the extracted folder.

     $ tar -xzf pulumi-v0.15.2-linux-x64.tar.gz
     $ ./pulumi/install.sh
    
  3. Add /usr/local/pulumi/bin to your path:

     echo "export PATH=\$PATH:/usr/local/pulumi/bin" >> ~/.profile
    

Windows Binaries

Windows 8 and 10 are supported.

  1. Download Pulumi 0.15.2 for Windows x64.

  2. Copy the extracted zipfile 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.

Uninstalling Pulumi

To uninstall Pulumi, delete the .pulumi folder in your home directory. If you used the manual installer, you should also delete the pulumi folder that was created.</div>

The current stable version is 0.15.2. For a full history of prior versions, including release notes, please visit the Change Log.

Ensuring It Worked

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

$ pulumi version
v0.15.2

If you get an error that pulumi could not be found, it means your path has not been configured correctly. Please go back and ensure your path contains the directory containing the pulumi CLI installed earlier.

Next Steps

Now choose a cloud to get started: