1. Docs
  2. Pulumi Cloud
  3. Administration
  4. Self-hosting
  5. Components
  6. Deployments

Pulumi Cloud self-hosted Deployments

    Self-hosting is only available with Pulumi Business Critical. If you would like to evaluate the Self-Hosted Pulumi Cloud, sign up for the 30 day trial or contact us.

    To manage your state with a self-managed backend, such as a cloud storage bucket, see State and Backends.

    Pulumi Deployments is fully supported in Kubernetes-managed self-hosted environments. If you’re using Kubernetes to manage your self-hosted Pulumi Cloud installation, you can enable Pulumi Deployments features by configuring a Kubernetes-native deployment pool in Pulumi Cloud and installing one or more customer-managed agents into your installation’s Kubernetes cluster.

    To do so, follow these steps:

    1. Create a new deployment pool. Navigate to Settings then Deployment runners in the left-hand menu of your Pulumi Cloud organization, click Add new pool, and copy the generated access token.

    2. Select the Kubernetes tab and follow the on-screen instructions to install and configure your Kubernetes-native deployment agent.

    3. Set any environment variables directly on your Kubernetes deployment. The following environment variables are supported and may be set on the container running the Pulumi Cloud API service:

      Variable NameDescriptionDefault
      PULUMI_DEPLOY_DEFAULT_IMAGE_REFERENCEThe Docker image to use for the runner.pulumi/pulumi
    4. Configure your stacks individually to use the deployment pool by navigating to Settings > Deploy and choosing the pool from the Deployment runner pools list. Click Save deployment configuration to apply your settings.

      PulumiUP 2024. Watch On Demand.