pulumi-install
Install Pulumi CLI
TLDR
Install packages and plugins
Install packages and plugins but skip dependencies
Install packages and reinstall existing plugins
SYNOPSIS
curl -fsSL https://get.pulumi.com | sh -s -- [OPTIONS]
wget -qO- https://get.pulumi.com | sh -s -- [OPTIONS]
PARAMETERS
--version <VERSION>
Specifies a particular version of the Pulumi CLI to install (e.g., v3.x.x). If omitted, the latest stable version is installed by default.
--install-dir <PATH>
Sets the target directory where the Pulumi CLI binaries will be placed. The default location is typically ~/.pulumi.
--no-modify-path
Prevents the installation script from automatically attempting to modify your shell's profile configuration file (e.g., .bashrc, .zshrc) to add the Pulumi binary to your system's PATH environment variable.
--yes
or --force
Runs the installation process non-interactively, bypassing any prompts for user confirmation during execution.
--help
Displays usage information and a list of available command-line options for the installation script.
DESCRIPTION
The pulumi-install utility, typically invoked by piping a shell script from get.pulumi.com into `sh`, automates the entire installation process for the Pulumi Command Line Interface (CLI) on Linux systems. This script handles downloading the correct Pulumi binary tailored to your system's architecture, extracting it, and placing it in a designated installation directory. A key feature is its default attempt to modify your shell's PATH environment variable, ensuring the pulumi command becomes immediately accessible from any terminal session. This streamlined approach significantly simplifies setup, removing the need for manual downloads, extractions, or complex, distribution-specific package management steps, making it ideal for quick developer onboarding.
CAVEATS
Internet connectivity is mandatory for the script to download both itself and the Pulumi CLI binaries.
By default, the script modifies your shell's configuration file (e.g., .bashrc, .zshrc). Users may need to restart their shell or manually source the configuration file for the PATH changes to take effect.
If the specified installation directory is a system-wide path (e.g., /usr/local/bin), root privileges (via sudo) will likely be required.
The script relies on common Linux utilities such as curl or wget for downloading, sh (or bash/zsh) for execution, and unzip/tar for archive extraction.
USAGE NOTES
The command is typically executed by piping the output of curl or wget directly into a shell interpreter (sh). This allows the installation script to run immediately after being downloaded, streamlining the entire installation process.
After a successful installation, you should generally run pulumi login to configure your Pulumi backend and authenticate your CLI.
HISTORY
The pulumi-install script is a foundational component of the Pulumi ecosystem, specifically engineered to deliver a consistent and user-friendly installation experience for the Pulumi CLI across various Linux distributions. Its development underscores Pulumi's commitment to simplifying developer onboarding and ensuring quick access to its infrastructure-as-code capabilities, by abstracting away the complexities of manual binary management or reliance on specific operating system package managers.