1. Docs
  2. Reference
  3. Registry URL reference

Pulumi Registry URL reference

    Pulumi uses registry:// URLs to reference resources in the Pulumi Registry, such as templates and packages. This page documents the URL format and usage.

    URL format

    registry://{resource-type}/{source}/{publisher}/{name}[@{version}]
    ComponentDescription
    resource-typeThe type of resource: templates or packages.
    sourceThe registry source or namespace (e.g., pulumi).
    publisherThe organization that published the resource.
    nameThe resource name.
    versionOptional. Semver version. If omitted, the latest version is used.

    Templates

    Reference templates published to the Pulumi Registry:

    registry://templates/{source}/{publisher}/{name}[@{version}]

    Examples:

    registry://templates/pulumi/community/aws-static-website@1.0.0
registry://templates/pulumi/official/kubernetes-cluster

    Templates are used in deployment settings to configure where Pulumi Deployments obtains source code. See Organization templates for more information on publishing and managing templates.

    Versioning

    • Specific version: Append @{version} to pin to a specific semver version (e.g., @1.0.0, @2.1.0-beta.1)
    • Latest version: Omit the version to use the latest published version

    When omitting the version, the latest version is resolved at the time of use. For reproducible deployments, specify an explicit version.