• HashiCorp Developer

  • HashiCorp Cloud Platform
  • Terraform
  • Packer
  • Consul
  • Vault
  • Boundary
  • Nomad
  • Waypoint
  • Vagrant
Terraform
  • Install
  • Tutorials
    • About the Docs
    • Configuration Language
    • Terraform CLI
    • Terraform Cloud
    • Terraform Enterprise
    • CDK for Terraform
    • Provider Use
    • Plugin Development
    • Registry Publishing
    • Integration Program
  • Registry(opens in new tab)
  • Try Cloud(opens in new tab)
  • Sign up
Terraform Home

Terraform Enterprise

Skip to main content
  • Terraform Enterprise

  • Overview
  • Operational Modes
    • Overview
      • Automated Recovery
      • Upgrades
      • Log Forwarding
      • Monitoring
      • Backups and Restores
      • Admin CLI Commands
      • Terraform Cloud Agents on TFE
      • Alternative Worker to Agent Migration
      • Demo to Mounted Disk Migration
  • Migrating to Terraform Enterprise
  • Support

  • Terraform Cloud Agents

  • Resources

  • Tutorial Library
  • Certifications
  • Community Forum
    (opens in new tab)
  • Support
    (opens in new tab)
  • GitHub
    (opens in new tab)
  • Terraform Registry
    (opens in new tab)
  1. Developer
  2. Terraform
  3. Terraform Enterprise
  4. Administration
  5. Infrastructure
  6. Upgrades
  • Terraform Enterprise
  • v202212-2
  • v202212-1
  • v202211-1
  • v202210-1
  • v202209-2
  • v202209-1
  • v202208-3
  • v202208-2
  • v202208-1
  • v202207-2
  • v202207-1
  • v202206-1

»Upgrading

This section explains how to upgrade Terraform Enterprise to a new version. Learn more about availability during upgrades here.

Before Upgrade

We strongly recommend the following:

  • Create a backup copy of the storage prior to upgrading your instance. Backup and restore responsibility varies depending on your Terraform Enterprise operation mode.
  • Review the general Terraform Enterprise requirements, including credentials, hardware, operating system, data storage, and network.
  • Review the upgrade requirements and release notes for the specific Terraform Enterprise release.

Online

Replicated Console

  1. From the installer dashboard (https://<TFE HOSTNAME>:8800/dashboard), click the "Check Now" button. Terraform recognizes the new version.
  2. Click "View Update".
  3. Review the release notes and then click "Install Update".

Replicated Command Line Interface

  1. Connect to the Terraform Enterprise host machine using SSH.

  2. Fetch the versions of Terraform Enterprise.

    $ replicatedctl app-release ls --fetch
    
  3. Upgrade to the latest version of Terraform Enterprise.

    $ replicatedctl app-release apply
    

    Alternatively, upgrade to a specific version of Terraform Enterprise.

    $ replicatedctl app-release apply --sequence "504"
    

Airgapped

Replicated Console

  1. Determine the update path where the installer will look for new .airgap packages. You can do this from the console settings of your instance (https://<TFE HOSTNAME>:8800/console/settings) in the field Update Path.
  2. Download the new .airgap package onto the instance and put it into the Update Path location.
  3. From the installer dashboard (https://<TFE HOSTNAME>:8800/dashboard) click the "Check Now" button. Terraform recognizes the new version.
  4. Click "View Update".
  5. Review the release notes and then click "Install Update".

Replicated Command Line Interface

  1. Connect to the Terraform Enterprise host machine using SSH.

  2. Print the AirgapPackagePath.

    $ replicatedctl params export --template '{{.AirgapPackagePath}}'
    
  3. On the Terraform Enterprise host machine, upload the desired airgap packages into the AirgapPackagePath.

  4. Fetch the versions of Terraform Enterprise from the uploaded airgap packages.

    $ replicatedctl app-release ls --fetch
    
  5. List the available versions of airgap packages for the upgrade.

    $ replicatedctl app-release ls
    
  6. Upgrade to the latest version of the available airgap packages.

    $ replicatedctl app-release apply
    

    Alternatively, upgrade to a specific version, using one of the options listed in the output of the previous step.

    $ replicatedctl app-release apply --sequence "504"
    
Edit this page on GitHub

On this page

  1. Upgrading
  2. Before Upgrade
  3. Online
  4. Airgapped
Give Feedback(opens in new tab)
  • Certifications
  • System Status
  • Terms of Use
  • Security
  • Privacy
  • Trademark Policy
  • Trade Controls
  • Give Feedback(opens in new tab)