How to Install Terraform Enterprise to a Specific Version

Introduction

This guide explains how to install a specific version of Terraform Enterprise instead of the latest available version.

Use Case

You may need to install a specific version of Terraform Enterprise for tasks such as restoring from a backup or performing a disaster recovery that requires matching a previous version. By default, the online installer script downloads and installs the latest version, but you can override this behavior by providing a specific release sequence number.

Procedure

To install a specific version, you must provide its unique release sequence number to the installer script. The following steps outline this process for an online installation.

1. Find the Release Sequence Number.

   You can find the release sequence number in two ways:

   • From an existing Terraform Enterprise instance: Navigate to the admin release page at https://<TFE_HOSTNAME>:8800/releases. The sequence number appears in parentheses next to the version number. For example, for a release listed as v202102-1 (507), the release sequence number is 507.
   • From the documentation: If you do not have an existing instance, refer to the Terraform Enterprise release notes to find the sequence number for your target version.

2. Download the installer script.

   Use curl to download the stable installer script.

   $ curl https://install.terraform.io/ptfe/stable > install.sh

3. Run the installer with the release-sequence flag.

   Execute the script with sudo and pass the release sequence number you identified in step 1. The installer script uses this flag to download the specified version instead of the latest.

   $ sudo bash install.sh release-sequence=<RELEASE_SEQUENCE_NUMBER>

   Replace <RELEASE_SEQUENCE_NUMBER> with your target version's sequence number.

4. Complete the installation.

   After running the command, proceed with the rest of the online installation process as described in the documentation. The installer will use the version you specified.