Define cloud apps and infrastructure in your favorite language and deploy to any cloud
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
build Use pipenv from the toolset Nov 8, 2018
cmd Display current logged in user Feb 1, 2019
dist/docker fix: overhaul the Dockerfile (#2442) Feb 14, 2019
examples Fix issue with comments throwing off function/class serialization (#2438 Feb 8, 2019
pkg Decrease log level for HTTP requests and responses (#2460) Feb 20, 2019
scripts Don't clobber `dev` tag from PR builds Jan 31, 2019
sdk Simplify how we export the .all operator (#2467) Feb 22, 2019
tests Enable delete parallelism for Python (#2443) Feb 12, 2019
.appveyor.yml Use dep 0.5.0 in Windows CI, to match Travis Jan 24, 2019
.dockerignore Add a Dockerfile for the Pulumi CLI Sep 29, 2018
.gitignore Add yarn.lock to gitignore Nov 12, 2018
.golangci.yml Adopt golangci-lint and address issues Nov 8, 2018
.travis.yml Run fewer jobs for PRs and pushes Feb 1, 2019
.yarnrc Pass --network-concurrency 1 to yarn Jan 29, 2018 Simplify how we export the .all operator (#2467) Feb 22, 2019 Adopt Contributor Covenant code of conduct May 30, 2018 Have point at Nov 13, 2018
Gopkg.lock Update Gopkg.lock for dep 0.5 Jan 20, 2019
Gopkg.toml Fix wierd interactions due to Cobra and glog Aug 20, 2018
LICENSE Relicense under Apache 2.0 May 22, 2018
Makefile Pass -count=1 to disable result caching on go 1.10 and above Nov 8, 2018 Add Roadmap to README (#2271) Dec 4, 2018
build.proj Pass -count=1 to disable result caching on go 1.10 and above Nov 8, 2018
main.go Fix main.go copyright header May 31, 2018
tslint.json Enable 'use const' linter rule. (#405) Oct 10, 2017

Slack NPM version Python version GoDoc License

Pulumi's Cloud Native SDK is the easiest way to create and deploy cloud programs that use containers, serverless functions, hosted services, and infrastructure, on any cloud.

Simply write code in your favorite language and Pulumi automatically provisions and manages your AWS, Azure, Google Cloud Platform, and/or Kubernetes resources, using an infrastructure-as-code approach. Skip the YAML, and use standard language features like loops, functions, classes, and package management that you already know and love.

For example, create three web servers:

let aws = require("@pulumi/aws");
let sg = new aws.ec2.SecurityGroup("web-sg", {
    ingress: [{ protocol: "tcp", fromPort: 80, toPort: 80, cidrBlocks: [""]}],
for (let i = 0; i < 3; i++) {
    new aws.ec2.Instance(`web-${i}`, {
        ami: "ami-7172b611",
        instanceType: "t2.micro",
        securityGroups: [ ],
        userData: `#!/bin/bash
            echo "Hello, World!" > index.html
            nohup python -m SimpleHTTPServer 80 &`,

Or a simple serverless timer that archives Hacker News every day at 8:30AM:

let cloud = require("@pulumi/cloud");
let snapshots = new cloud.Table("snapshots");
cloud.timer.daily("daily-yc-snapshot", { hourUTC: 8, minuteUTC: 30 }, () => {
    let req = require("https").get("", (res) => {
        let content = "";
        res.on("data", (chunk) => { content += chunk });
        res.on("end", () => {
           snapshots.insert({ date:, content: content });

Many examples are available spanning containers, serverless, and infrastructure in pulumi/examples.

Pulumi is open source under the Apache 2.0 license, supports many languages and clouds, and is easy to extend. This repo contains the pulumi CLI, language SDKs, and core Pulumi engine, and individual libraries are in their own repos.


  • Getting Started: get up and running quickly.

  • Tutorials: walk through end-to-end workflows for creating containers, serverless functions, and other cloud services and infrastructure.

  • Examples: browse a number of useful examples across many languages, clouds, and scenarios including containers, serverless, and infrastructure.

  • A Tour of Pulumi: interactively walk through the core Pulumi concepts, one at a time, covering the entire CLI and programming model surface area in a handful of bite-sized chunks.

  • Reference Docs: read conceptual documentation, in addition to details on how to configure Pulumi to deploy into your AWS, Azure, or Google Cloud accounts, and/or Kubernetes cluster.

  • Community Slack: join us over at our community Slack channel. Any and all discussion or questions are welcome.

  • Roadmap: check out what's on the roadmap for the Pulumi project over the coming months.

Getting Started

Follow these steps to deploy your first Pulumi program, using AWS Serverless Lambdas, in minutes:

  1. Install:

    To install the latest Pulumi release, run the following (see full installation instructions for additional installation options):

    $ curl -fsSL | sh
  2. Configure your Cloud Provider so that Pulumi can deploy into it.

  3. Create a Project:

    After installing, you can get started with the pulumi new command:

    $ pulumi new hello-aws-javascript

    The new command offers templates for all languages and clouds. Run it without an argument and it'll prompt you with available projects. This command created an AWS Serverless Lambda project written in JavaScript.

  4. Deploy to the Cloud:

    Run pulumi update to get your code to the cloud:

    $ pulumi update

    This makes all cloud resources needed to run your code. Simply make edits to your project, and subsequent pulumi updates will compute the minimal diff to deploy your changes.

  5. Use Your Program:

    Now that your code is deployed, you can interact with it. In the above example, we can curl the endpoint:

    $ curl $(pulumi stack output url)
  6. Access the Logs:

    If you're using containers or functions, Pulumi's unified logging command will show all of your logs:

    $ pulumi logs -f
  7. Destroy your Resources:

    After you're done, you can remove all resources created by your program:

    $ pulumi destroy -y

Please head on over to the project website for much more information, including tutorials, examples, and an interactive tour of the core Pulumi CLI and programming model concepts.



Architecture Build Status
Linux/macOS x64 Linux x64 Build Status
Windows x64 Windows x64 Build Status


Language Status Runtime
JavaScript Stable Node.js 6.x-10.x
TypeScript Stable Node.js 6.x-10.x
Python Preview Python 2.7
Go Preview Go 1.x


Cloud Status Docs
Amazon Web Services Stable Docs
Microsoft Azure Preview Docs
Google Cloud Platform Preview Docs
Kubernetes Preview Docs


There are several libraries that encapsulate best practices and common patterns:

Library Status Docs Repo
AWS Serverless Preview Docs pulumi/pulumi-aws-serverless
AWS Infrastructure Preview Docs pulumi/pulumi-aws-infra
Pulumi Multi-Cloud Framework Preview Docs pulumi/pulumi-cloud


Please See for information on building Pulumi from source or contributing improvments.