Skip to main content
Pulumi logo Pulumi logo
  1. Docs
  2. Download & install Pulumi

Download & install Pulumi

    The latest version of Pulumi is 3.277.0. See available versions for earlier releases and the changelog for what’s new.

    Install Pulumi

    Install Pulumi with Homebrew:

    $ brew install pulumi/tap/pulumi

    Verify the installation:

    $ pulumi version

    If the command isn’t found, see Troubleshooting.

    Other ways to install on macOS

    Community Homebrew

    Use the community-supported formula if you don’t have the Pulumi tap:

    $ brew install pulumi

    MacPorts

    $ sudo port install pulumi

    Install script

    The script installs Pulumi to ~/.pulumi/bin and adds it to your PATH, or tells you how when it can’t:

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

    Manual installation

    1. Download the archive for your Mac: Apple silicon (arm64) Intel (x64)

    2. From the directory you downloaded it to, extract the archive and move its files to ~/.pulumi/bin:

      $ tar -xzf pulumi-*.tar.gz
      $ mkdir -p ~/.pulumi/bin
      $ mv pulumi/* ~/.pulumi/bin/
      
    3. Add ~/.pulumi/bin to your PATH in your shell profile, which is ~/.zshrc for the default macOS shell:

      $ echo 'export PATH=$PATH:$HOME/.pulumi/bin' >> ~/.zshrc
      
    4. Open a new terminal and run pulumi version.

    Install Pulumi with the Windows Package Manager:

    > winget install --exact --id Pulumi.Pulumi

    Verify the installation:

    > pulumi version

    If the command isn’t found, see Troubleshooting.

    Other ways to install on Windows

    Installer (MSI)

    Download the installer for your machine: x64 arm64

    Chocolatey

    Run the following from an administrator shell:

    > choco install pulumi

    Install script

    The script installs Pulumi to %USERPROFILE%\.pulumi\bin for your user account only, so it doesn’t need administrator rights. Run it from a command prompt (cmd.exe):

    > @"%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"

    Manual installation

    1. Download the zip file: x64 arm64

    2. From the folder you downloaded it to, extract it to C:\ in PowerShell. The zip contains a pulumi folder, so this creates C:\pulumi\bin:

      > Expand-Archive pulumi-*.zip -DestinationPath C:\
      
    3. Add C:\pulumi\bin to your PATH. In System Properties > Advanced > Environment Variables, select Path under User variables, then select Edit > New.

    4. Open a new terminal and run pulumi version.

    Install Pulumi with the install script:

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

    Verify the installation:

    $ pulumi version

    If the command isn’t found, see Troubleshooting.

    Other ways to install on Linux

    Manual installation

    1. Download the archive: x64 arm64

    2. From the directory you downloaded it to, extract the archive and move its files to ~/.pulumi/bin:

      $ tar -xzf pulumi-*.tar.gz
      $ mkdir -p ~/.pulumi/bin
      $ mv pulumi/* ~/.pulumi/bin/
      
    3. Add ~/.pulumi/bin to your PATH in your shell profile. For bash:

      $ echo 'export PATH=$PATH:$HOME/.pulumi/bin' >> ~/.bashrc
      
    4. Open a new terminal and run pulumi version.


    Next steps

    After you download, run pulumi new in an empty directory, and choose a template for your cloud and language of choice:

    $ mkdir my-project; cd my-project
    $ pulumi new

    By default, you’ll be prompted to sign into Pulumi Cloud, the default backend for the Pulumi CLI. Pulumi Cloud is completely free for individuals and manages your IaC state, secrets, and configuration automatically. To manage your state on your own, see using a DIY backend.

    Guides and resources


    Upgrade Pulumi

    Upgrade Pulumi the same way you installed it.

    Homebrew

    $ brew update && brew upgrade pulumi

    MacPorts

    $ sudo port selfupdate && sudo port upgrade pulumi

    Install script or manual installation: Run the install script again, or repeat the manual installation steps with the new archive.

    winget

    > winget upgrade --exact --id Pulumi.Pulumi

    Chocolatey

    > choco upgrade pulumi

    Installer, install script, or manual installation: Run the new installer or the install script again, or repeat the manual installation steps with the new zip file.

    Install script

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

    Manual installation: Repeat the manual installation steps with the new archive.


    Install a specific version or a dev build

    To install a specific version, replace <version> with a version number from available versions. To install the latest dev build, which includes every change merged to the main branch of pulumi/pulumi, use dev as the version.

    Install script

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

    winget and Chocolatey only have released versions. For a dev build, use the install script.

    winget

    > winget install --exact --id Pulumi.Pulumi --version <version>

    Chocolatey

    > choco install pulumi --version <version>

    Install script: Run it from a command prompt (cmd.exe):

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

    Install script

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

    Install Pulumi skills for your coding agent

    Pulumi skills are structured knowledge packages that follow the open Agent Skills specification. They work with most coding agents, including Claude Code, GitHub Copilot, Cursor, VS Code, Codex, and Gemini CLI. Once they’re installed, your coding agent can follow Pulumi’s workflows and code patterns for common infrastructure tasks.

    Claude Code plugin marketplace

    In Claude Code, the plugin marketplace is the quickest way to install:

    claude plugin marketplace add pulumi/agent-skills
    claude plugin install pulumi-migration      # Install migration skills
    claude plugin install pulumi                # Install Pulumi skills (overview + specialized)
    claude plugin install pulumi-delegation     # Install delegation skills (Neo handoff)
    

    You can install all plugin groups or choose only the ones you need.

    Other coding agents

    For Cursor, GitHub Copilot, VS Code, Codex, Gemini CLI, and other coding agents, use the universal Agent Skills CLI. The universal installer does not read plugin marketplace manifests, so install each end-user skill group:

    npx skills add pulumi/agent-skills/pulumi --skill '*'
    npx skills add pulumi/agent-skills/migration --skill '*'
    npx skills add pulumi/agent-skills/delegation --skill '*'
    

    You can also connect your coding agent to the Pulumi MCP server for live access to your Pulumi Cloud stacks, resources, and the Pulumi Registry.


    Troubleshooting

    pulumi: command not found

    If your shell can’t find pulumi after you install it, open a new terminal so it picks up the updated PATH. If it still isn’t found, add the directory Pulumi was installed to your PATH:

    Install methodDirectory
    Homebrew/opt/homebrew/bin on Apple silicon, /usr/local/bin on Intel Macs
    MacPorts/opt/local/bin
    Install script (macOS and Linux)~/.pulumi/bin
    Install script (Windows)%USERPROFILE%\.pulumi\bin
    winget or the installer (MSI)Added to your PATH automatically. Open a new terminal.
    Chocolatey$($env:ChocolateyInstall)\lib\pulumi\tools\Pulumi\bin
    Manual installation~/.pulumi/bin on macOS and Linux, C:\pulumi\bin on Windows

    New version warning

    When a newer version is available, the CLI prints a warning like this one:

    warning: A new version of Pulumi is available. To upgrade from version '3.200.0' to '3.277.0', run
       $ brew update && brew upgrade pulumi
    or visit https://pulumi.com/docs/install/ for manual instructions and release notes.
    

    The command in the warning depends on how you installed Pulumi. When the CLI can’t tell, it links to this page. See Upgrade Pulumi.

    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.


    Minimum system requirements

    These are the minimums for typical use. Larger programs and programs that use many providers need more.

    ComponentRecommendation
    Operating systemmacOS 13 (Ventura) or later, Windows 10 or Windows Server 2016 or later, or Linux; on x64 or arm64
    CPU2 GHz or faster processor (or equivalent vCPUs for cloud environments)
    RAM4 GB or more
    Disk space1 GB or more free disk space, plus room for language runtimes and provider plugins

    Uninstall Pulumi

    Uninstall Pulumi the same way you installed it.

    If you use a local DIY backend at its default location, the .pulumi folder in your home directory holds your stack state. Back it up before you delete the folder.

    Homebrew

    $ brew uninstall pulumi

    MacPorts

    $ sudo port uninstall pulumi

    Install script: Delete the .pulumi folder in your home directory. Then remove the # add Pulumi to the PATH line and the export PATH line after it from your shell profile, such as ~/.zshrc or ~/.bashrc.

    Manual installation: Delete the .pulumi folder in your home directory, and remove the export PATH line you added to your shell profile.

    winget

    > winget uninstall --exact --id Pulumi.Pulumi

    Chocolatey

    > choco uninstall pulumi

    Installer (MSI): Uninstall Pulumi from Settings > Apps > Installed apps.

    Install script: Delete the .pulumi folder in your home directory. Then remove %USERPROFILE%\.pulumi\bin from your user PATH in System Properties > Advanced > Environment Variables.

    Manual installation: Delete C:\pulumi, and remove C:\pulumi\bin from your user PATH.

    Install script: Delete the .pulumi folder in your home directory. Then remove the # add Pulumi to the PATH line and the export PATH line after it from your shell profile, such as ~/.zshrc or ~/.bashrc.

    Manual installation: Delete the .pulumi folder in your home directory, and remove the export PATH line you added to your shell profile.

    Whichever method you used, delete the .pulumi folder in your home directory too. It holds plugins, credentials, and the install script’s copy of the CLI.

      The infrastructure platform for humans and agents.