Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Ionoscloud
  3. Installation & Configuration
IonosCloud v0.2.3 published on Tuesday, May 13, 2025 by ionos-cloud
ionos-cloud/pulumi-ionoscloud

Ionoscloud: Installation & Configuration

ionoscloud logo
IonosCloud v0.2.3 published on Tuesday, May 13, 2025 by ionos-cloud
ionos-cloud/pulumi-ionoscloud

    Installation

    The Pulumi Ionoscloud provider is available as a package in most Pulumi languages:

    Provider Binary

    The Ionoscloud provider binary is a third party binary. It can be installed using the pulumi plugin command.

    pulumi plugin install resource ionoscloud vX.Y.Z --server github://api.github.com/ionos-cloud/pulumi-ionoscloud

    Replace the version string with your desired version.

    Setup

    To provision resources with the Pulumi Ionoscloud provider, you need to have Ionoscloud credentials. Your Ionoscloud credentials are never sent to pulumi.com. Pulumi uses the Ionoscloud API and the credentials in your environment to authenticate requests from your computer to Ionoscloud.

    The provider needs to be configured with the proper credentials before it can be used. Requests to the Ionoscloud APIs require generating a token. See Token Management for a detailed explanation.

    Environment Variables

    Environment VariableDescription
    IONOS_USERNAMESpecify the username used to login, to authenticate against the IONOS Cloud API
    IONOS_PASSWORDSpecify the password used to login, to authenticate against the IONOS Cloud API
    IONOS_TOKENSpecify the token used to login, if a token is being used instead of username and password
    IONOS_API_URLSpecify the API URL. It will overwrite the API endpoint default value api.ionos.com. It is not necessary to override this value unless you have special routing config
    IONOS_LOG_LEVELSpecify the Log Level used to log messages. Possible values: Off, Debug, Trace
    IONOS_PINNED_CERTSpecify the SHA-256 public fingerprint here, enables certificate pinning
    IONOS_CONTRACT_NUMBERSpecify the contract number on which you wish to provision. Only valid for reseller accounts, for other types of accounts the header will be ignored
    IONOS_S3_ACCESS_KEYSpecify the access key used to authenticate against the IONOS Object Storage API
    IONOS_S3_SECRET_KEYSpecify the secret key used to authenticate against the IONOS Object Storage API
    IONOS_S3_REGIONRegion for IONOS Object Storage operations. Default value: eu-central-3. If you use IONOS_API_URL_OBJECT_STORAGE, IONOS_S3_REGION is mandatory
    ionoscloud logo
    IonosCloud v0.2.3 published on Tuesday, May 13, 2025 by ionos-cloud
    ionos-cloud/pulumi-ionoscloud