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/pulumiVerify the installation:
$ pulumi versionIf 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 pulumiMacPorts
$ sudo port install pulumiInstall 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 | shManual installation
Download the archive for your Mac: Apple silicon (arm64) Intel (x64)
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/Add
~/.pulumi/binto yourPATHin your shell profile, which is~/.zshrcfor the default macOS shell:$ echo 'export PATH=$PATH:$HOME/.pulumi/bin' >> ~/.zshrcOpen a new terminal and run
pulumi version.
Install Pulumi with the Windows Package Manager:
> winget install --exact --id Pulumi.PulumiVerify the installation:
> pulumi versionIf 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 pulumiInstall 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
From the folder you downloaded it to, extract it to
C:\in PowerShell. The zip contains apulumifolder, so this createsC:\pulumi\bin:> Expand-Archive pulumi-*.zip -DestinationPath C:\Add
C:\pulumi\binto yourPATH. In System Properties > Advanced > Environment Variables, select Path under User variables, then select Edit > New.Open a new terminal and run
pulumi version.
Install Pulumi with the install script:
$ curl -fsSL https://get.pulumi.com | shVerify the installation:
$ pulumi versionIf the command isn’t found, see Troubleshooting.
Other ways to install on Linux
Manual installation
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/Add
~/.pulumi/binto yourPATHin your shell profile. For bash:$ echo 'export PATH=$PATH:$HOME/.pulumi/bin' >> ~/.bashrcOpen 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 newBy 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 pulumiMacPorts
$ sudo port selfupdate && sudo port upgrade pulumiInstall 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.PulumiChocolatey
> choco upgrade pulumiInstaller, 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 | shManual 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 method | Directory |
|---|---|
| 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.
| Component | Recommendation |
|---|---|
| Operating system | macOS 13 (Ventura) or later, Windows 10 or Windows Server 2016 or later, or Linux; on x64 or arm64 |
| CPU | 2 GHz or faster processor (or equivalent vCPUs for cloud environments) |
| RAM | 4 GB or more |
| Disk space | 1 GB or more free disk space, plus room for language runtimes and provider plugins |
Uninstall Pulumi
Uninstall Pulumi the same way you installed it.
.pulumi folder in your home directory holds your stack state. Back it up before you delete the folder.Homebrew
$ brew uninstall pulumiMacPorts
$ sudo port uninstall pulumiInstall 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.PulumiChocolatey
> choco uninstall pulumiInstaller (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.