How to add a Terraform Version to Terraform Enterprise

Use Case

This is how to manually add a Terraform binary to your Terraform Enterprise installation that it currently does not have available for selection.

Procedure

If you are adding an official version of Terraform:

1. Access this page through a user with admin privileges to your TFE installation: https://TFE_HOSTNAME/app/admin/terraform-versions/add

2. Fill in the fields seen on the page as shown below:

   • Version: Enter the number of the version that you are adding
   • Enable this version: check this box if desired
   • Beta: do not check this box if not desired
   • URL: Paste this address, then replace the X's with the version of Terraform you are adding: https://releases.hashicorp.com/terraform/X.X.X/terraform_X.X.X_linux_amd64.zip
   • SHA256 Checksum: Paste this address into a new tab on your browser, then modify the X's with the version of terraform you are adding to download a file with the checksum contained within: https://releases.hashicorp.com/terraform/X.X.X/terraform_X.X.X_SHA256SUMS
     • Open the downloaded file that will be named terraform_X.X.X_SHA256SUMS
     • Copy the checksum, which will be the long line of 64 characters to the left of the name of the zip file you pointed to in the URL field, which should be terraform_X.X.X_linux_amd64.zip
3. Click on Add terraform version

If you are adding a custom version of Terraform:

1. Access this page through a user with admin privileges to your TFE installation: https://TFE_HOSTNAME/app/admin/terraform-versions/add

2. Fill in the fields seen on the page as shown below:

   • Version: Enter the number of the custom version that you are adding
   • Enable this version: check this box if desired
   • Beta: do not check this box if not desired
   • URL: Enter the address to where the zip file of your custom version of Terraform is hosted
   • SHA256 Checksum: Paste the checksum for the zip file you are hosting of the custom version of Terraform
     
     • Run these commands against the zip file to obtain it's sha256 checksum:
       • Linux: sha256sum /path/to/file
       • Mac: shasum -a 256 /path/to/file
       • Windows: 
         • PowerShell: Get-FileHash C:\path\to\file -Algorithm SHA256
         • CMD: CertUtil -hashfile C:\path\to\file SHA256
3. Click on Add terraform version

Expected Outcome

Once this is complete, you should be able to configure workspaces with the new Terraform version you added.

Additional Information

• Terraform Versions | HashiCorp Releases