1. Docs
  2. Infrastructure as Code
  3. Concepts
  4. Converters

Converters

    Converters are plugins that deterministically translate infrastructure as code written in other tools into Pulumi programs in any supported Pulumi language.

    For most conversions, using an LLM is the recommended first option. Pulumi Neo, part of Pulumi Cloud, can convert your infrastructure code using AI. For Terraform specifically, Neo has a specialized migration skill.

    Supported converters

    Converter--from valueDescription
    TerraformterraformConverts Terraform HCL to Pulumi
    Azure Resource Manager (ARM)armConverts ARM JSON templates to Pulumi
    Azure BicepbicepConverts Bicep templates to Pulumi
    KuberneteskubernetesConverts Kubernetes YAML manifests to Pulumi

    Using a converter

    Run pulumi convert with the --from flag to specify the converter and --language to specify the target Pulumi language:

    pulumi convert --from terraform --language typescript

    Converters are installed automatically when you run pulumi convert. For detailed usage and options, see the pulumi convert CLI reference.

    For step-by-step migration guides for each source tool, see Migrating to Pulumi.

    Manual installation

    Converter plugins are installed automatically, but you can also install them manually using pulumi plugin install:

    pulumi plugin install converter terraform
pulumi plugin install converter arm
pulumi plugin install converter bicep
pulumi plugin install converter kubernetes

    Manual installation is useful for pre-loading plugins in CI/CD pipelines or air-gapped environments. See plugin installation for more details.