# Pulumi > Infrastructure as code in real programming languages. Define, deploy, and manage cloud infrastructure on AWS, Azure, Google Cloud, Kubernetes, and hundreds of providers using TypeScript, JavaScript, Python, Go, .NET, Java, YAML, or HCL. Pulumi is an open-source infrastructure as code platform that lets you use familiar programming languages and tools to build, deploy, and manage cloud infrastructure. Pulumi Cloud provides state management, secrets, deployments, governance, an internal developer platform, and infrastructure AI for teams. Pulumi works with the coding agent you already use (Claude Code, Codex, Cursor, and others), and Pulumi Neo is its purpose-built infrastructure agent. ## For agents If you are an AI agent or programmatic consumer, start here. Each docs page linked below holds the full contract with copy-pasteable examples, and is also served as markdown. - [Pulumi Cloud REST API via the CLI](https://www.pulumi.com/docs/iac/cli/api/): call any [Pulumi Cloud REST API](https://www.pulumi.com/docs/reference/cloud-rest-api/) endpoint with `pulumi api` (experimental), with a stable JSON error envelope and [exit codes](https://www.pulumi.com/docs/iac/cli/exit-codes/); `pulumi api list --output=json` returns the endpoint catalog - [Pulumi Cloud OpenAPI spec](https://api.pulumi.com/api/openapi/pulumi-spec.json): the OpenAPI document `pulumi api` reads, for clients that call the REST API directly - [Registry API for agents](https://www.pulumi.com/docs/reference/registry-api/): every published package, version by version (README, installation, nav, type docs, examples), with endpoints, parameters, and auth for private packages - [Provider schemas](https://www.pulumi.com/docs/reference/registry-api/#provider-schemas): the full Pulumi schema for any provider, version-pinned through the Registry API or via `pulumi package get-schema [@version]` - [Markdown access](https://www.pulumi.com/docs/reference/registry-api/#markdown-access-to-docs-pages): every `/docs/` URL is served as markdown with `Accept: text/markdown` or a `.md` suffix (`/docs/iac/concepts/resources/` becomes `/docs/iac/concepts/resources.md`) - [Docs index (JSON)](https://www.pulumi.com/docs/llm-sitemap.json): hierarchical sitemap of every page in the docs navigation, with titles and nesting; pageless headings are `"group": true` nodes with no `path`, off-site links carry `"external": true` and a `url`, and CLI command pages are listed at [/docs/iac/cli/commands/](https://www.pulumi.com/docs/iac/cli/commands/) - [Context API](https://www.pulumi.com/docs/discovery-governance/concepts/context-api/): query one graph of IaC state, stack dependencies, and discovered cloud resources (public preview); fetch its schema with `pulumi api GetGraphQuerySchema` - [CLI for agents](https://www.pulumi.com/docs/ai/concepts/cli-for-agents/): run any command with `npx pulumi`, with an [ephemeral Pulumi Cloud account](https://www.pulumi.com/docs/administration/concepts/agent-accounts/) provisioned on first use when `PULUMI_ENABLE_AUTOMATIC_AGENT_SIGNUP=true` is set - [Coding agents](https://www.pulumi.com/docs/ai/coding-agents/): use Pulumi with the coding agent you already use (Claude Code, Codex, Cursor, and others) - [Pulumi Agent Skills](https://www.pulumi.com/docs/ai/concepts/agent-skills/): proven Pulumi workflows for agents; install with `npx skills add pulumi/agent-skills/pulumi --skill '*'` - [Pulumi MCP server](https://www.pulumi.com/docs/ai/guides/set-up-mcp-server/): hosted MCP server exposing stacks, resource search, and the Registry as tools - [MCP endpoint](https://mcp.ai.pulumi.com/mcp): the Streamable HTTP endpoint to add to an MCP client, e.g. `claude mcp add --transport http pulumi https://mcp.ai.pulumi.com/mcp` - [API catalog](https://www.pulumi.com/.well-known/api-catalog): RFC 9727 linkset of Pulumi's public APIs - [Hand off to Pulumi Neo](https://www.pulumi.com/docs/ai/coding-agents/handoff/): delegate an infrastructure task from a coding agent to Pulumi Neo - [Support request API](https://www.pulumi.com/docs/support/support-request-api/): file a support ticket with one JSON POST to `https://www.pulumi.com/api/support`, no auth; never send a `leave_blank` key, it is a spam trap that silently discards the request ## Site overview This llms.txt covers www.pulumi.com, which includes: - [Product](https://www.pulumi.com/product.md): Every Pulumi product in one place: infrastructure as code, secrets and configuration, release pipelines, agents, and policy - [Pulumi IaC](https://www.pulumi.com/product/infrastructure-as-code.md): Write infrastructure in TypeScript, Python, Go, C#, Java, or YAML and deploy to any cloud, with previews and tests before anything changes - [Pulumi ESC](https://www.pulumi.com/product/secrets-management.md): Pulumi ESC pulls secrets and configuration from every vault and cloud into one place, with short-lived credentials and the same access controls everywhere - [Pulumi Agents](https://www.pulumi.com/product/agents.md): Work with Neo, set up agents that investigate incidents, drift, and failed deployments on their own, or use Pulumi with your own coding agent - [Pulumi Delivery](https://www.pulumi.com/product/delivery.md): Write your release pipeline as a Pulumi program, and Pulumi Delivery runs each release through your stages and approval gates - [Discovery & governance](https://www.pulumi.com/product/discovery-governance.md): Find every resource across your clouds, audit it against CIS, NIST, and PCI DSS, and block non-compliant changes before they deploy - [Pulumi IDP](https://www.pulumi.com/product/internal-developer-platforms.md): Give engineers self-service infrastructure through golden paths built from your components, templates, and policies - [Self-hosted Pulumi Cloud](https://www.pulumi.com/product/self-hosted.md): Run Pulumi Cloud in your own cloud account, data center, or air-gapped network, including inside a FedRAMP authorization boundary - [Get started](https://www.pulumi.com/up/): Guided first project for any cloud and language - [Pricing](https://www.pulumi.com/pricing.md): Pulumi Cloud editions and pricing (Free, Essentials, Pro, Enterprise) - [Pulumi Registry](https://www.pulumi.com/registry.md): Documentation for hundreds of cloud providers and components, available at `https://www.pulumi.com/registry/packages//` - [Infrastructure AI](https://www.pulumi.com/docs/ai.md): Write Pulumi code with [your coding agent](https://www.pulumi.com/docs/ai/coding-agents.md), or investigate incidents and maintain infrastructure with [Pulumi Agents](https://www.pulumi.com/docs/ai/agents.md), including the pre-built [Pulumi Neo](https://www.pulumi.com/docs/ai/concepts/neo.md) and your own [custom agents](https://www.pulumi.com/docs/ai/agents/custom.md) - [Blog](https://www.pulumi.com/blog/): Product announcements, technical guides, and engineering posts - [Releases](https://www.pulumi.com/releases/): Pulumi Cloud and CLI changelog, also available as [JSON](https://www.pulumi.com/releases/index.json) with edition availability per entry - [Dev Center](https://www.pulumi.com/dev.md): Tutorials, templates, community examples, and a glossary. Has an index of its own at [/dev/llms.txt](https://www.pulumi.com/dev/llms.txt), and every detail page has a markdown twin at its URL plus `.md` - [Topics](https://www.pulumi.com/topics/): Explainer pages for cloud infrastructure concepts (e.g., infrastructure as code, Kubernetes, serverless). Has an index of its own at [/topics/llms.txt](https://www.pulumi.com/topics/llms.txt) - [Customers](https://www.pulumi.com/customers.md): Companies running their infrastructure on Pulumi, and the case studies behind them - [Automation API](https://www.pulumi.com/automation/): Program-driven Pulumi for embedding infrastructure as code into applications and platforms - [Whitepapers](https://www.pulumi.com/whitepapers/): Long-form educational and technical content - [Community](https://www.pulumi.com/community.md): Slack, GitHub, events, and the Puluminaries - [Security](https://www.pulumi.com/security/): Security posture, compliance, and trust information - [Docs](https://www.pulumi.com/docs/index.md): Technical documentation (detailed sections below) ## Docs sections ### Download & install - [Download & Install Pulumi](https://www.pulumi.com/docs/install.md): This page contains detailed instructions for downloading and installing Pulumi. ### Infrastructure as code - [Infrastructure as Code](https://www.pulumi.com/docs/iac.md): Learn how to create, deploy, and manage infrastructure on any cloud using Pulumi's open source infrastructure as code SDK. - [Concepts](https://www.pulumi.com/docs/iac/concepts.md): Learn how Pulumi's SDK, CLI, deployment engine, providers, and Pulumi Cloud work together to provision and manage cloud infrastructure as code. - [Basics](https://www.pulumi.com/docs/iac/guides/basics.md): Learn fundamental practices for organizing Pulumi projects, securing your infrastructure, and managing deployments. - [Building & Extending](https://www.pulumi.com/docs/iac/guides/building-extending.md): Learn how to build custom components, providers, and packages to extend Pulumi's capabilities. - [Clouds](https://www.pulumi.com/docs/iac/guides/clouds.md): Infrastructure as Code guides for AWS and Azure with Pulumi. - [Migration](https://www.pulumi.com/docs/iac/guides/migration.md): Learn how Pulumi compares to other solutions, how to migrate to Pulumi, use converters to convert your code to Pulumi, and import resources to Pulumi. - [Testing](https://www.pulumi.com/docs/iac/guides/testing.md): Guide to automated testing of Pulumi programs: unit testing, property testing, integration testing. - [Operations](https://www.pulumi.com/docs/iac/operations.md): Run Pulumi day-to-day — stack management, continuous delivery, troubleshooting, debugging, and least-privilege security for infrastructure after it's deployed. - [Languages & SDKs](https://www.pulumi.com/docs/iac/languages-sdks.md): An overview of how to use Node.js, Python, Go, .NET, Java, YAML, and HCL when writing cloud applications for AWS, Azure, Google Cloud, Kubernetes, etc. - [Pulumi CLI](https://www.pulumi.com/docs/iac/cli.md): An overview of the Pulumi CLI and common commands used to deploy cloud applications. - [Comparisons](https://www.pulumi.com/docs/iac/comparisons.md): Learn how Pulumi compares with alternative infrastructure as code solutions that may share overlapping capabilities. ### Infrastructure AI - [Infrastructure AI](https://www.pulumi.com/docs/ai.md): Write, preview, and deploy infrastructure with your coding agent, or use Pulumi Agents to investigate issues and prepare code changes. - [Get started](https://www.pulumi.com/docs/ai/get-started.md): Start a task with Pulumi Agents, create an agent for your team, or set up your coding agent to work with Pulumi. - [Pulumi Agents](https://www.pulumi.com/docs/ai/agents.md): Delegate ongoing infrastructure responsibilities to managed AI agents running in Pulumi Cloud. Configure their instructions, tools, and access for your team. - [Use your coding agent](https://www.pulumi.com/docs/ai/coding-agents.md): Use Pulumi skills, the MCP server, and the CLI with Claude Code, Codex, Cursor, and other coding agents. - [Organization AI settings](https://www.pulumi.com/docs/ai/concepts/neo/settings.md): Control organization AI access, configure agent model providers and integrations, and set Neo task defaults. - [Reference](https://www.pulumi.com/docs/ai/reference.md): API, MCP tool, and CLI references for working with Pulumi Agents and external coding agents. ### Deployments & workflows - [Deployments & Workflows](https://www.pulumi.com/docs/deployments.md): Cloud-hosted deployment automation, drift detection, and workflow management for infrastructure as code. - [Get Started with Pulumi Deployments](https://www.pulumi.com/docs/deployments/get-started.md): A list of guides to get started using Pulumi Deployments - [Concepts](https://www.pulumi.com/docs/deployments/concepts.md): What Pulumi Deployments is, why it exists, and an overview of its core concepts. - [Guides](https://www.pulumi.com/docs/deployments/guides.md): Task-oriented guides for Pulumi Deployments — cloud credentials, custom images, customer-managed runners, private sources, OIDC, and dependent stack updates. - [Operations](https://www.pulumi.com/docs/deployments/operations.md): Operational details of Pulumi Deployments — the permissions a deployment runs with and how deployments are queued and executed. - [Vs. Traditional CI/CD](https://www.pulumi.com/docs/deployments/versus.md): Learn how Pulumi Deployments differs from traditional CI/CD systems and why it's uniquely suited for infrastructure as code. ### Delivery - [Delivery](https://www.pulumi.com/docs/delivery.md): Pulumi Delivery lets you write your release pipeline as a Pulumi program and promote each release through stages, stacks, jobs, and approval gates. - [Get started](https://www.pulumi.com/docs/delivery/get-started.md): Register your first Pulumi Delivery pipeline and deploy a release through dev, staging, and prod, with a manual gate before production. - [Concepts](https://www.pulumi.com/docs/delivery/concepts.md): How Pulumi Delivery models a release pipeline as a Pulumi program, and how pipelines, runs, stages, stacks, jobs, artifacts, sources, and releases relate. - [Guides](https://www.pulumi.com/docs/delivery/guides.md): Task-oriented guides for Pulumi Delivery, covering cloud credentials for each stage, common pipeline patterns, and connecting pipelines. - [Limits](https://www.pulumi.com/docs/delivery/limits.md): Size and time limits for Pulumi Delivery pipelines and runs. ### Secrets & configuration (ESC) - [Secrets & Configuration](https://www.pulumi.com/docs/esc.md): Learn how to tame secrets sprawl and configuration complexity securely across all your cloud infrastructure and applications. - [Get Started](https://www.pulumi.com/docs/esc/get-started.md): Get started with Pulumi ESC. Create an environment, store a secret, retrieve it, and consume it from a Pulumi IaC stack. - [Concepts](https://www.pulumi.com/docs/esc/concepts.md): Pulumi ESC is a centralized secrets and configuration management service. Learn its core concepts and how it works when you open an environment. - [Providers](https://www.pulumi.com/docs/esc/providers.md): Reference catalog of Pulumi ESC login providers and secrets and configuration providers. - [Rotators](https://www.pulumi.com/docs/esc/providers/rotators.md): Pulumi ESC rotators replace credentials for AWS IAM, Azure apps, MySQL, PostgreSQL, Snowflake, and custom services on a schedule or on demand. - [Operations](https://www.pulumi.com/docs/esc/operations.md): Run Pulumi ESC day-to-day — review environment changes, rotate credentials, deploy rotation connectors, and inject environment values into commands and CI jobs. - [Guides](https://www.pulumi.com/docs/esc/guides.md): Step-by-step guides for using Pulumi ESC with Docker, direnv, GitHub Actions, Kubernetes, Cloudflare, and Pulumi IaC. - [Integrations](https://www.pulumi.com/docs/esc/integrations.md): First-party Pulumi ESC integrations — Pulumi Service Provider, Automation API, VS Code extension, External Secrets Operator, and Secrets Store CSI Driver. - [Administration](https://www.pulumi.com/docs/esc/administration.md): Administer Pulumi ESC alongside the rest of your Pulumi Cloud organization, with audit logs, deletion protection, and customer managed keys. - [Languages & SDKs](https://www.pulumi.com/docs/esc/languages-sdks.md): Manage Pulumi ESC environments programmatically from .NET, Go, JavaScript, and Python. - [Comparisons](https://www.pulumi.com/docs/esc/vs.md): Learn how Pulumi ESC compares with alternative Environments, Secrets, and Configurations solutions. ### Discovery & governance - [Discovery & governance](https://www.pulumi.com/docs/discovery-governance.md): Discover, secure, and govern cloud infrastructure with comprehensive visibility and policy enforcement across all your resources. - [Get started](https://www.pulumi.com/docs/discovery-governance/get-started.md): Learn how to set up and manage cloud accounts to gain visibility into your cloud infrastructure. - [Concepts](https://www.pulumi.com/docs/discovery-governance/concepts.md): Core concepts behind Pulumi Discovery, Pulumi Policies, and the Context API, including cloud accounts, discovered stacks, policy packs, and policy groups. - [Guides](https://www.pulumi.com/docs/discovery-governance/guides.md): Task-oriented guides for Discovery & governance, including connecting cloud accounts, importing resources, writing policy packs, and querying the Context API. - [Operations](https://www.pulumi.com/docs/discovery-governance/operations.md): Run Discovery & governance day to day, including reviewing policy findings and running scans and policy evaluations on your own infrastructure. - [Reference](https://www.pulumi.com/docs/discovery-governance/reference.md): Reference for Pulumi Policies, including pulumi policy CLI commands, the Policy SDK and REST API, PulumiPolicy.yaml, and policy fields. ### Internal developer platform - [Internal Developer Platform](https://www.pulumi.com/docs/idp.md): Build self-service infrastructure workflows with reusable components, templates, and golden paths—from Day 0 to Day 2. - [Concepts](https://www.pulumi.com/docs/idp/concepts.md): Learn about the concepts and components of Pulumi IDP. - [Guides](https://www.pulumi.com/docs/idp/guides.md): Guides for building secure, scalable, and flexible developer workflows with Pulumi IDP - [Integrations](https://www.pulumi.com/docs/idp/integrations.md): Integrate Pulumi IDP with developer portals and embed self-service deployment workflows in the tools your developers already use. ### Administration - [Administration](https://www.pulumi.com/docs/administration.md): Manage organizations, teams, access control, security, and self-hosted deployments. - [Get Started](https://www.pulumi.com/docs/administration/get-started.md): Learn how to onboard your entire team to Pulumi, and build out your infrastructure platform, with built-in security, best practices, and compliance. - [Concepts](https://www.pulumi.com/docs/administration/concepts.md): The Pulumi Cloud organization and access model: organizations, SAML SSO, SCIM, accounts, access tokens, RBAC, audit logs, and customer-managed keys. - [Guides](https://www.pulumi.com/docs/administration/guides.md): Task-oriented guides for administering Pulumi Cloud — SAML SSO, SCIM, OIDC issuers, audit log export, customer-managed keys, and least privilege. - [Reference](https://www.pulumi.com/docs/administration/reference.md): Lookup material for administering Pulumi Cloud — the catalogs of RBAC scopes and audit log events, the log export formats, and the Cloud REST API. - [Self-hosting](https://www.pulumi.com/docs/administration/self-hosting.md): The Pulumi Enterprise edition gives you the option to self-host Pulumi within your organization's infrastructure. ### Integrations - [Integrations](https://www.pulumi.com/docs/integrations.md): Integrations connect Pulumi with the clouds, version control systems, and tools you already use. - [Clouds](https://www.pulumi.com/docs/integrations/clouds.md): Pulumi integrates with AWS, Azure, Google Cloud, Kubernetes, and thousands of other providers through the Pulumi Registry. - [Version Control](https://www.pulumi.com/docs/integrations/version-control.md): Connect Pulumi with your version control system using integrations for GitHub, GitLab, Azure DevOps, Bitbucket, and custom Git or Mercurial VCS providers. - [Terraform & OpenTofu](https://www.pulumi.com/docs/integrations/terraform.md): Use Pulumi with Terraform and OpenTofu. Store state and run plans in Pulumi Cloud, use Terraform providers and modules, reference state, or convert HCL. - [Pulumi VS Code Extension](https://www.pulumi.com/docs/integrations/vs-code.md): Use the Pulumi VS Code extension to debug programs, get Pulumi YAML language support, and manage ESC environments without leaving your editor. ### Reference - [Reference](https://www.pulumi.com/docs/reference.md): Complete reference documentation for Pulumi CLI, Cloud REST API, language SDKs, and configuration syntax. - [Pulumi CLI](https://www.pulumi.com/docs/iac/cli.md): An overview of the Pulumi CLI and common commands used to deploy cloud applications. - [Registry URL reference](https://www.pulumi.com/docs/reference/registry-urls.md): Reference documentation for Pulumi Registry URLs used to reference templates and packages. - [Registry API for agents](https://www.pulumi.com/docs/reference/registry-api.md): Query every published Pulumi package, version by version, through the cloud registry API: endpoints, parameters, schemas, and markdown access for agents. - [REST API Docs](https://www.pulumi.com/docs/reference/cloud-rest-api.md): Overview of the Pulumi Cloud REST API. Query organization, stack, and state data; call any endpoint from the pulumi api CLI. - [Property Paths](https://www.pulumi.com/docs/reference/property-paths.md): Property Paths are used to refer to elements in a configuration object. - [PulumiPlugin.yaml Reference](https://www.pulumi.com/docs/reference/pulumiplugin-yaml.md): Documentation of the settings that are valid for the PulumiPlugin.yaml plugin manifest used by source-based component packages. - [Pulumi glossary](https://www.pulumi.com/docs/reference/glossary.md): A list of common terms and their definitions relating to Pulumi. ### Support - [Support & Troubleshooting](https://www.pulumi.com/docs/support.md): Get help with Pulumi through FAQs, troubleshooting guides, community resources, and support options. - [Getting Support](https://www.pulumi.com/docs/support/getting-support.md): Learn what Pulumi support is available to your organization — community channels, paid support plans, and how to upgrade. - [Provider support policy](https://www.pulumi.com/docs/support/provider-support-policy.md): How long Pulumi maintains each provider major version, which providers get long-term support, and what a long-term support release contains. - [Support request API](https://www.pulumi.com/docs/support/support-request-api.md): File a Pulumi support request with a single JSON POST to /api/support, without driving the web form. Fields, limits, and status codes. - [Filing GitHub Issues](https://www.pulumi.com/docs/support/filing-issues.md): Learn how to file bugs and feature requests in the correct Pulumi repository for faster resolution. - [Frequently Asked Questions](https://www.pulumi.com/docs/support/faq.md): Frequently asked questions about using Pulumi across infrastructure, secrets, policies, and platform features. ## Optional ### Recent blog posts - [Everything after code, as code](https://www.pulumi.com/blog/everything-after-code-as-code/): Introducing Pulumi Delivery and Pulumi Agents: your release process in code, and agents that send production fixes back as code. - [Introducing Pulumi Delivery: your release pipeline as code](https://www.pulumi.com/blog/introducing-pulumi-delivery/): Pulumi Delivery is in public preview. Write release pipelines in TypeScript, Python, Go, C#, Java, YAML, or HCL, with approval gates and AI risk review. - [Introducing Pulumi Agents](https://www.pulumi.com/blog/introducing-pulumi-agents/): Introducing Pulumi Agents: AI agents you can create and customize to carry out infrastructure tasks and ongoing responsibilities for your team. - [Pulumi at KubeCon NA 2026: attendee guide](https://www.pulumi.com/blog/pulumi-at-kubecon-na-2026/): Where to find Pulumi at KubeCon NA 2026 in Salt Lake City: booth 200, talks from our team, Platform Engineering Day, and KubeNight Out. - [Manage Pulumi ESC change requests from the CLI](https://www.pulumi.com/blog/esc-change-requests-cli/): The new `pulumi env change-request` commands let you review, approve, and apply Pulumi ESC change requests from the CLI. - [Running Pulumi Neo in a Docker Sandbox: workshop recap](https://www.pulumi.com/blog/running-pulumi-neo-in-a-docker-sandbox/): Pulumi Neo can take on real infrastructure work once its limits sit outside the prompt. What our Docker workshop taught us about running Neo in a sandbox. - [AI infrastructure on tap with the Pulumi AICR provider](https://www.pulumi.com/blog/self-hosted-ai-infrastructure-pulumi-aicr/): The Pulumi NVIDIA AI Cluster Runtime (AICR) provider deploys pre-validated GPU training and inference clusters across clouds in a few lines of Python. - [Assign policy groups by stack and account tags](https://www.pulumi.com/blog/assign-policy-groups-by-tags/): Policy groups can now add stacks and cloud accounts by tag, so new infrastructure gets the right policy coverage automatically as it's created. - [Pulumi ESC now issues OIDC tokens for any service](https://www.pulumi.com/blog/esc-oidc-tokens-for-any-service/): Pulumi ESC now signs short-lived OIDC tokens for any audience you set, with a stable subject you can pin in each service's trust policy. - [Scale your team's use of AWS IAM account access manager with Pulumi](https://www.pulumi.com/blog/scale-your-teams-use-of-aws-iam-account-access-manager-with-pulumi/): Manage AWS IAM account access manager (AAM) as code with Pulumi: define IAM roles, applications, and entitlements across your AWS organization in one program.