# [Pulumi](https://learn.arm.com/install-guides/pulumi/) ## About this Install Guide | Reading time: | 5 min | |----------------------|---------------| | Last updated: | 4 Aug 2026 | | Ecosystem dashboard: | [View](https://developer.arm.com/ecosystem-dashboard/linux?package=pulumi) | This guide shows you how to install and use the tool with the most common configuration. For advanced options and complete reference information, see the official documentation. Some install guides also include optional next steps to help you explore related workflows or integrations. [Pulumi](https://www.pulumi.com/) is a multi-language infrastructure as code (IaC) tool. Pulumi is [open source](https://github.com/pulumi/pulumi) and makes it easy to deploy cloud infrastructure. Pulumi is available for a variety of operating systems and Linux distributions. In this guide, you’ll learn how to install Pulumi on Linux. ## Install Pulumi Run the following command to download and install Pulumi on Linux: ```bash curl -fsSL https://get.pulumi.com | sh ``` The installer output is similar to: ``` __output__=== Installing Pulumi v3.255.0 === __output__+ Downloading https://github.com/pulumi/pulumi/releases/download/v3.255.0/pulumi-v3.255.0-linux-arm64.tar.gz... __output__ % Total % Received % Xferd Average Speed Time Time Time Current __output__ Dload Upload Total Spent Left Speed __output__ 0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0 __output__100 129M 100 129M 0 0 11.1M 0 0:00:11 0:00:11 --:--:-- 11.1M __output__+ Extracting to /home/ubuntu/.pulumi/bin __output__+ Adding $HOME/.pulumi/bin to $PATH in /home/ubuntu/.bashrc __output__=== Pulumi is now installed! 🍹 === __output__+ Please restart your shell or add /home/ubuntu/.pulumi/bin to your $PATH __output__+ Get started with Pulumi: https://www.pulumi.com/docs/quickstart ``` The installer updates `$HOME/.bashrc` to setup the environment. Start a new shell or run the following command: ```bash source $HOME/.bashrc ``` Confirm `pulumi` is now in the search path: ```bash which pulumi ``` ``` __output__/usr/local/bin/pulumi ``` Print the version: ```bash pulumi version ``` ``` __output__v3.255.0 ``` ## Verify Pulumi installation with an example Pulumi keeps your projects and state information in Pulumi Cloud, making it easy to access them from anywhere. If you want to use Pulumi Cloud, see [app.pulumi.com](https://app.pulumi.com/). It’s not necessary to use Pulumi Cloud to get started. You can store project information on your local computer. The following is an example to try out Pulumi. The example uses Docker to pull a container image from Docker Hub to your local machine using Python. To run the example, you need to install Docker. For instructions, see the [Docker install guide](/install-guides/docker/). You also need Python. Make sure you have `python` and `pip` installed. For `Ubuntu 22.04` on Arm, you can run the following commands to install: ```bash sudo apt install python-is-python3 -y sudo apt install python3-pip -y ``` Create a new directory for the example: ```bash mkdir pulumi-test; cd pulumi-test ``` Log in to your local machine, a shortcut to use `~/.pulumi` to store project data. ```bash pulumi login --local ``` For the example, you need to create 3 files: - Python required package list in `requirements.txt` - Pulumi project information in `Pulumi.yaml` - Python code in `__main__.py` Use a text editor to copy the code below to a file named `requirements.txt`. ``` __output__pulumi>=3.0.0 __output__pulumi-docker>=4.0.0 ``` Use a text editor to copy the lines below to a file named `Pulumi.yaml` ``` name: alpine-pull runtime: python description: A pulumi application pull the alpine image ``` Use a text editor to copy the lines below to a file named `__main__.py` ```python import pulumi import pulumi_docker as docker # Pull the latest Alpine image: image = docker.RemoteImage("alpineImage", name="alpine:latest", keep_locally=True) # Print the digest: pulumi.export('digest', image.repo_digest) ``` With the three files created, install the required Python packages: ```bash pip install -r requirements.txt ``` Run the Python script to pull the container image: ```bash pulumi up ``` There are 4 prompts to respond to: 1. Confirm you want to create a new stack. Press return 2. Enter a name for the stack. 3. When prompted, enter a passphrase for the stack twice. 4. Answer `yes` to the final question to create the stack. The output of `pulumi up` is similar to: ``` __output__Please choose a stack, or create a new one: [Use arrows to move, type to filterPlease choose a stack, or create a new one: __output__Please enter your desired stack name: test1 __output__Created stack 'test1' __output__Enter your passphrase to protect config/secrets: __output__Re-enter your passphrase to confirm: __output__Previewing update (test1): Type Name Plan __output__ + pulumi:pulumi:Stack alpine-pull-test1 create __output__ + └─ docker:index:RemoteImage alpineImage create __output__Outputs: digest: output __output__Resources: + 2 to create __output__Do you want to perform this update? yes __output__Updating (test1): Type Name Status __output__ + pulumi:pulumi:Stack alpine-pull-test1 created (0.07s) __output__ + └─ docker:index:RemoteImage alpineImage created (0.03s) __output__Outputs: digest: "alpine@sha256:7144f7bab3d4c2648d7e59409f15ec52a18006a128c733fcff20d3a4a54ba44a" __output__Resources: + 2 created __output__Duration: 1s ``` After the Python script runs, you have the container on your machine. Confirm this using the `docker images` command: ```bash docker images ``` The output is similar to: ``` __output__REPOSITORY TAG IMAGE ID CREATED SIZE __output__alpine latest f6648c04cd6c 2 days ago 7.66MB ``` You are now ready to use Pulumi on your Linux machine.