How to Manage Terraform Versions
Tags: terraform, opentofu, tutorial, devops
Published: 2024-06-17 20:32:07



The simplest method for handling Terraform versions is to [tenv](https://github.com/tofuutils/tenv). [tenv](https://github.com/tofuutils/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
```

### Windows
```
choco install tenv
```

### 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](https://github.com/tofuutils/tenv/blob/main/README.md).

## Manage Terraform versions via tenv version manager

![manage terraform version](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/44cifcpwr84w47lh0dvd.jpg)


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
```
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
```

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](https://github.com/tofuutils/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
```

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](https://github.com/tofuutils/tenv/blob/main/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](https://github.com/tofuutils/tenv/discussions)!

Press a star 🌟 [on GitHub](https://github.com/tofuutils/tenv) if you like the tenv version manager.