tfversion

A simple tool to manage Terraform versions.

Brew

To install tfversion using brew, simply run:

brew install tfversion/tap/tfversion

Binaries

You can download the latest binary for Linux, MacOS, and Windows.

Configuring your shell

To ensure that tfversion is always available in your shell, append the following line to your shell profile (e.g., .bashrc, .zshrc or fish config):

export PATH="$HOME/.tfversion/bin:$PATH"

We prefer to not automagically modify your shell profile, and therefore leave this step to you.

Examples

tfversion is user-friendly and easy to use. For more information, please visit the documentation.

Install a specific version

tfversion install 1.7.0

Install the latest stable version

tfversion install --latest

Install the latest pre-release version

tfversion install --latest --pre-release

Install the required version for your current directory

tfversion install --required

Use a specific version

tfversion use 1.7.0

Use the latest stable version

tfversion use --latest

Use the latest pre-release version

tfversion use --latest --pre-release

Use the required version for your current directory

tfversion use --required

Automatically install a version when using

tfversion use 1.7.4 --install
tfversion use --latest --install

Create and use an alias

tfversion alias default 1.7.4
tfversion use default

List versions

tfversion list

List installed versions

tfversion list --installed

List aliased versions

tfversion list --aliases

List pre-release versions

tfversion list --pre-release

Uninstall a specific version

tfversion uninstall 1.7.4

Display the currently activated version of Terraform

tfversion current

Contributing

Contributions are highly appreciated and always welcome. Have a look through existing Issues and Pull Requests that you could help with.