DEV Community

Cover image for How to Manage Terraform Versions
kvendingoldo
kvendingoldo

Posted on

How to Manage Terraform Versions

The simplest method for handling Terraform versions is to tenv. tenv is a version manager for Terraform, OpenTofu, Terragrunt, and Atmos, written in Go. This versatile version manager simplifies the complexity of version control, helping to avoid spending time on IaC tools’ version management and ensuring developers and DevOps can focus on what is important the most - crafting innovative products and driving business value.

Why do I need Terraform version manager?

Managing a single Terraform project makes installing, upgrading, or switching to tools like OpenTofu straightforward. However, handling multiple projects with different Terraform versions can be challenging. Regular upgrades and tool switches require careful coordination to maintain functionality and stability across projects. The list of key challenges:

  • Version Compatibility: Different projects may need specific Terraform versions, which might not be backward compatible.

  • Dependency Management: Dependencies for each project must match the Terraform version of that project.

  • Environment Consistency: It becomes challenging to maintain consistency throughout the development, staging, and production environments.

  • Tooling and Integration: Various Terraform versions may require modifications to CI/CD pipelines and integrations.

tenv terraform version manager cover all described challenged under the hood in a single binary that helps to manage Terraform versions transparently.

🚀 tenv installation

MacOS

brew install tenv
Enter fullscreen mode Exit fullscreen mode

Windows

choco install tenv
Enter fullscreen mode Exit fullscreen mode

Linux

For Linux, you can install tenv version manager via packaged binaries (.deb, .rpm, .apk, pkg.tar.zst , .zip or .tar.gz format) by visiting the release page or by apk/yay/snap/nix package managers. To get more information about the Linux tenv installation, check README.md.

Manage Terraform versions via tenv version manager

manage terraform version

Once you have tenv version manager installed, you can use it to install specific versions of Terraform. To install Terraform, do the following steps:

Open a terminal, go to the directory with Terraform code (if you have any) and execute the following command to install terraform version:

tenv tf install
Enter fullscreen mode Exit fullscreen mode

Based on .tf code, tenv version manager automatically detect and install the necessary version of Terraform. If no version detected in sources, the latest version will be installed.

On the other hand, if necessary, a specific Terraform version can also be installed. Let's try to install Terraform 1.8.5:

tenv tf install 1.8.5
Enter fullscreen mode Exit fullscreen mode

The install command also supports version constraints such as:

  • latest - the latest available stable version
  • latest-pre - the latest available version, including unstable ones
  • latest-allowed or min-required - tenv will scan your Terraform files to detect which version is maximally allowed or minimally required.

Now, verify the Terraform version. To do it, use the following command:

terraform version
Enter fullscreen mode Exit fullscreen mode

That's it. No symlinks, additional commands or download required. To read about more installation cases for Terraform, you can check the official README.md file.

Support Us, Contact Us

If you like this post, support us, download tenv, try to use it and give us feedback in our official discussions channel!

Press a star 🌟 on GitHub if you like the tenv version manager.

Top comments (0)