pulumi-version

Display version

$ pulumi version

$ pulumi version [[-h|--help]]

pulumi version [--json] [--no-color]

--json
    Output the version information in a machine-readable JSON format. This is particularly useful for scripting and integrating Pulumi version checks into automated workflows.

--no-color
    Disable colorized output. This option is beneficial when running the command in environments that do not support ANSI color codes, or when capturing output for log files where colors might be undesirable.

The pulumi version command is a utility within the Pulumi Command Line Interface (CLI) used to retrieve and display the current version of the Pulumi CLI installed on your system. This command is crucial for various purposes:

Verification: Confirms that Pulumi is correctly installed and accessible.
Troubleshooting: Helps in diagnosing issues by providing context about the CLI environment.
Compatibility: Ensures your CLI version is compatible with your Pulumi projects, cloud providers, or other Pulumi services.
Updates: Identifies if your CLI is outdated and requires an upgrade.

The output typically includes the CLI version number, Git commit hash, and build date, offering a comprehensive overview of the installed Pulumi toolchain. It supports different output formats for scripting and automation.

This command specifically reports the version of the Pulumi CLI executable. It does not provide information about the versions of individual Pulumi SDKs or provider packages (e.g., @pulumi/aws, pulumi-kubernetes) used within a Pulumi project. Those dependencies are managed separately by language-specific package managers (e.g., npm, pip, Go modules).

The Pulumi CLI must be installed and available in the system's PATH for this command to execute successfully.

To update your Pulumi CLI to the latest version, it is generally recommended to re-run the installation script (e.g., curl -fsSL https://get.pulumi.com/ | sh for Linux/macOS) or use the package manager through which Pulumi was originally installed (e.g., brew upgrade pulumi for Homebrew users).

The pulumi version command has been an integral part of the Pulumi CLI since its initial public releases. Its primary function—to provide immediate feedback on the installed client version—has remained consistent, reflecting its foundational role in the Pulumi ecosystem. It serves as a quick and reliable way for users to check their environment.

pulumi(1), pulumi login(1), pulumi up(1)