1. Docs
  2. Pulumi IaC
  3. Download & install

Download & install Pulumi

    The latest version of Pulumi is 3.135.1. For previous versions, see Available versions. For a list of features, bug fixes, and more see the CHANGELOG.

    Choose an operating system

    Homebrew Package Manager

    $ brew install pulumi/tap/pulumi
    

    macOS Binary Download

    amd64 arm64

    macOS Sierra (10.12) or later is required.

    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.

    Install Script

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

    Linux Binary Download

    amd64

    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.

    Installer (MSI)

    amd64

    Windows Binary Download

    amd64

    Windows 8 and later are supported.

    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.

    More installation methods

    In addition, there are many ways to install Pulumi:

    You can install Pulumi through the Homebrew package manager and using our official Pulumi Homebrew Tap

    $ 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
    

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

    $ brew install pulumi
    

    You can install Pulumi through the MacPorts package manager:

    $ 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
    

    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.

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

    1. Download Pulumi 3.135.1 for macOS. For prior versions and release notes, see the Available versions page.
    1. Extract the tarball and move the binaries in the pulumi directory to a directory included in your system’s $PATH.

    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.

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

    1. Download Pulumi 3.135.1 for Linux x64. For prior versions and release notes, see the Available versions page.
    1. Extract the tarball and move the binaries in the pulumi directory to a directory included in your system’s $PATH.

    You can install Pulumi using elevated permissions through the Chocolatey package manager:

    > 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
    

    Install Pulumi using the Windows Package Manager winget CLI. This is built-in on Windows 11 and later.

    > winget install pulumi
    

    To update Pulumi to a more recent version:

    > winget upgrade pulumi
    

    Download the latest Pulumi Installer for Windows x64 and run it like any other installer. It will automatically add Pulumi to the path and make it available machine-wide.

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

    2. 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.

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

    1. Download Pulumi 3.135.1 binaries for Windows x64. For prior versions and release notes, see the Available versions page.
    1. Unzip the file and extract the contents to a folder such as C:\pulumi.

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

    Verify installation

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

    $ pulumi version
    v3.135.1
    
    $ pulumi version
    v3.135.1
    
    > pulumi version
    v3.135.1
    

    Common errors and 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.135.1', 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.135.1', 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.135.1', 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.

    macOS Installation Script

    $ curl -fsSL https://get.pulumi.com | sh -s -- --version <version>
    

    Linux 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>
    

    Windows Installation Script

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

    2. 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"
    

    Installing dev releases

    In addition to installing a specific version, the latest dev version can also be installed automatically. This version contains the latest changes that have been merged to the main development branch.

    macOS Installation Script

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

    Linux Installation Script

    To install, run our installation script:

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

    Windows Installation Script

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

    2. 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')) -version dev" && 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.

      PulumiUP 2024. Watch On Demand.