Download Pulumi
macOS Sierra (10.12) or later is required.
The latest version of Pulumi is 3.37.2. For older versions, see Available Versions.
Pulumi supports many clouds using the same languages, CLI, and deployment workflow. For a streamlined Pulumi walkthrough, including language runtime installation and cloud configuration, see the Get Started guides.
Other Installation Methods
In addition, there are many ways to install Pulumi:
$ brew install pulumi/tap/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
$ brew install pulumi
$ sudo port install pulumi
This will install the pulumi
CLI to /opt/local/bin/pulumi
and add it to your path.
Subsequent updates can be installed through the upgrade outdated
command:
$ sudo port upgrade outdated
$ 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.
- Download Pulumi 3.37.2 for macOS. For prior versions and release notes, see the Available Versions page.
- Extract the tarball and move the binaries in the
pulumi
directory to a directory included in your system’s$PATH
.
Install Script
$ curl -fsSL https://get.pulumi.com | sh
Linux Binary Download
The latest version of Pulumi is 3.37.2. For older versions, see Available Versions.
Pulumi supports many clouds using the same languages, CLI, and deployment workflow. For a streamlined Pulumi walkthrough, including language runtime installation and cloud configuration, see the Get Started guides.
Other Installation Methods
In addition, there are many ways to install Pulumi:
$ 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.
- Download Pulumi 3.37.2 for Linux x64. For prior versions and release notes, see the Available Versions page.
- Extract the tarball and move the binaries in the
pulumi
directory to a directory included in your system’s$PATH
.
Windows 8 and later are supported.
The latest version of Pulumi is 3.37.2. For older versions, see Available Versions.
Pulumi supports many clouds using the same languages, CLI, and deployment workflow. For a streamlined Pulumi walkthrough, including language runtime installation and cloud configuration, see the Get Started guides.
Other Installation Methods
In addition, there are many ways to install Pulumi:
> choco install pulumi
This will install the pulumi
CLI to the usual place (often $($env:ChocolateyInstall)\lib\pulumi
) and generate the shims (usually $($env:ChocolateyInstall)\bin
) to add Pulumi your path.
Subsequent updates can be installed in the usual way:
> choco upgrade pulumi
> winget install pulumi
To update Pulumi to a more recent version:
> winget upgrade pulumi
- Run our installation script:
> @"%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.
- Download Pulumi 3.37.2 binaries for Windows x64. For prior versions and release notes, see the Available Versions page.
Unzip the file and extract the contents to a folder such as
C:\pulumi
.Add
C:\pulumi\bin
to your path via System Properties -> Advanced -> Environment Variables -> User Variables -> Path -> Edit.
Verifying your Installation
After installing Pulumi, verify everything is in working order by running the pulumi
CLI:
$ pulumi version
v3.37.2
$ pulumi version
v3.37.2
> pulumi version
v3.37.2
Common Errors or Warnings
These are common installation-related errors or warnings you may encounter.
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 '2.17.26' to '3.37.2', run
$ curl -sSL https://get.pulumi.com | sh
or visit https://pulumi.com/docs/reference/install/ for manual instructions and release notes.
warning: A new version of Pulumi is available. To upgrade from version '2.17.26' to '3.37.2', run
$ curl -sSL https://get.pulumi.com | sh
or visit https://pulumi.com/docs/reference/install/ for manual instructions and release notes.
warning: A new version of Pulumi is available. To upgrade from version '2.17.26' to '3.37.2', run
> "%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'))"
or visit https://pulumi.com/docs/reference/install/ for manual instructions and release notes.
If you're in an environment with no internet access, you may skip the Pulumi version update check by setting the environment variable
PULUMI_SKIP_UPDATE_CHECK
to 1
or true
.
Upgrading Pulumi
If you are upgrading from Pulumi 2.0 to 3.0, please see our migration guide.
Installing Betas and Previous Versions
Most installation methods choose the latest version by default. To install a specific version, use the following commands. You can find the list of versions on the Available Versions page.
Installation Script
$ curl -fsSL https://get.pulumi.com | sh -s -- --version <version>
Installation Script
To install, run our installation script:
$ curl -fsSL https://get.pulumi.com | sh -s -- --version <version>
Chocolatey
You can specify a specific version with Chocolatey package manager:
> choco install pulumi --version <version>
Installation Script
Open a new command prompt window (WIN+R:
cmd.exe
):Run our installation script (replace
<version>
with the version number):
> @"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; $version = '<version>'; iex ((New-Object System.Net.WebClient).DownloadString('https://get.pulumi.com/install.ps1')).Replace('${Version}', $version)" && SET "PATH=%PATH%;%USERPROFILE%\.pulumi\bin"
Uninstalling Pulumi
To uninstall Pulumi, use your installation method’s command of choice. If you installed Pulumi manually, delete the pulumi
directory that you created. Afterwards, remove the .pulumi
folder from your home directory which contains plugins and other cached metadata.