---
sourceDocument: Yokohama IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/it-operations-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Upgrading the Terraform environment

# Upgrading the Terraform environment {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Understand the high-level workflows for upgrading the Terraform
environment.

Upgrading Terraform Open Source
:   {#information-for-upgrading-terraform__table_q4s_2c1_w5b__entry__2}

    | Upgrade method | Description |
    |-|-|
    | Upgrade the existing Terraform Open Source installation to a newer supported version | Note: If you choose to upgrade the existing Terraform Open Source installation, you may experience a longer upgrade time. Perform the following actions to upgrade the existing Terraform Open Source installation: 1. Upgrade the Terraform Open Source server to a version that is supported by the Cloud Provisioning and Governance: Terraform Connector. For more information on upgrading Terraform, see Upgrade Guides in [Terraform documentation](https://www.terraform.io/docs). Cloud Provisioning and Governance: Terraform Connector supports Terraform Open Source versions 1.1.0 through 1.1.9 and 1.2.0. 2. Test and modify the existing Terraform templates to ensure compatibility with the target Terraform Open Source version. 3. Update the Terraform Open Source version mentioned in the Terraform Open Source config provider. {#information-for-upgrading-terraform__ol_c5t_lc1_w5b} |
    | Set up a new Terraform server with the desired Terraform Open Source version | Perform the following actions to set up a new Terraform server with the desired Terraform Open Source version: 1. Create a Linux or Windows server for Terraform Open Source installation. 2. Install a Terraform Open Source version that is supported by the Cloud Provisioning and Governance: Terraform Connector. Cloud Provisioning and Governance: Terraform Connector supports Terraform Open Source versions 1.1.0 through 1.1.9 and 1.2.0. 3. Copy the existing Terraform templates to the new Terraform server. Note: Ensure that all the templates are stored in separate directories and all the template directories are in the same base directory. 4. Test and modify the copied Terraform templates to ensure compatibility with the target Terraform Open Source version. 5. Create a Terraform Open Source config provider. For more information, see [Create a Terraform Open Source config provider](https://www.servicenow.com/docs/MC9kz03hkBOFfsDUVmaWEw "Create a Terraform Open Source config provider in Cloud Provisioning and Governance. The Terraform Open Source config provider enables Cloud Provisioning and Governance to discover the Terraform Open Source config installables (Terraform templates) and detect changes in them."). 6. Remove the old catalog items per the business strategy of your organization, and then retire the old Terraform server. {#information-for-upgrading-terraform__ol_ltn_5d1_w5b} |
    [Table 1. Upgrade methods for Terraform Open Source]

    {#information-for-upgrading-terraform__table_q4s_2c1_w5b}

Upgrading Terraform Enterprise and Terraform Cloud

:   Test and modify the existing Terraform templates to ensure compatibility with
    the new Terraform Enterprise or Terraform Cloud version.

    Note:  
    The stacks and Terraform workspaces are tied to the Terraform version through which they were provisioned. Therefore, the same Terraform version is used to provision and deprovision a stack or Terraform workspace.