The tfswitch command-line tool lets you switch between different versions of Terraform.
If you do not have a particular version of Terraform installed, tfswitch will download and verify the version you desire.
The installation is minimal and easy.
Once installed, simply select the version you require from the dropdown and start using Terraform.
Click here for our extended documentation.
Going forward we will change the version identifier of tfswitch to align with the common go package versioning.
Please be advised to change any automated implementation you might have that is relying on the tfswitch version string.
Old version string: 0.1.2412
New version string: v1.0.0 Note the v that is preceding all version numbers.
tfswitch is available as a binary and on various package managers (eg. Homebrew).
For macOS or various Linux distributions, Homebrew offers the simplest installation process. If you do not have Homebrew installed, click here.
Important
brew install tfswitchNote
For users who want the latest release as soon as it is published, you can install tfswitch from our Homebrew tap:
brew install warrensbox/tap/tfswitchThe official Homebrew formula, brew install tfswitch, remains the recommended installation method for most users. The tap is mainly for users who want to get new releases before they are picked up by the main Homebrew repository.
Installation for Linux operating systems.
curl -L https://raw.githubusercontent.com/warrensbox/terraform-switcher/master/install.sh | bash# compiled from source
yay tfswitch
# precompiled
yay tfswitch-binDownload and extract the Windows version of tfswitch that is compatible with your system.
We are building binaries for 386, amd64, arm6 and arm7 CPU structure.
See the release page for your download.
Alternatively, you can build tfswitch from source by cloning the repository and running make tfswitch. The binary will be created in the build directory, or you can run make install to install it to ~/bin/ on supported platforms.
You can also download a pre-compiled binary directly from the releases page.
See our installation documentation for more details.
Important
The version identifier of tfswitch has changed to align with the common go package versioning.
Version numbers will now be prefixed with a v - eg. v1.0.3.
Please change any automated implementations relying on the tfswitch version string.
Old version string: 0.1.2412
New version string: v1.0.3
Execute tfswitch and select the desired Terraform version via the dropdown menu.
Use tfswitch 1.7.0 to install Terraform version 1.7.0. Replace the version number as required.
More usage guide here
An open source project becomes meaningful when people collaborate to improve the code.
Feel free to look at the code, critique and make suggestions. Let's make tfswitch better!
See step-by-step instructions on how to contribute here: Contribute
See how to upgrade and uninstall or troubleshoot
Please open issues here: New Issue