How to unpin Terraform Enterprise Release Version

Problem

When attempting to upgrade Terraform Enterprise, the Updates page in the admin console shows that the release is pinned to a specific version, which prevents upgrades to newer releases. The user interface may display a message similar to the following:

Release is Pinned to v202201-1

This prevents administrators from selecting and installing newer versions.

Prerequisites

• Command-line access to the Terraform Enterprise instance with sufficient privileges to run replicatedctl commands.

Solution

To unpin the release, you need to reset the ReleaseSequence parameter using the replicatedctl command-line utility.

1. Connect to the Terraform Enterprise instance using ssh.

2. Execute the following command to reset the release pin. Setting the value to 0 makes all available releases visible for an upgrade.

   $ replicatedctl params set ReleaseSequence --value 0

Outcome

After running the command, navigate back to the Updates page in the Terraform Enterprise admin console. The release pin message is no longer present, and all available upgrade versions are listed and can be selected for installation.

Additional Information

For more details on managing your installation, please refer to the official Terraform Enterprise upgrade documentation.