Home

Awesome

Build Status Go Report Card GitHub Release GitHub Downloads (all assets, all releases) GitHub go.mod Go version

Terraform Switcher

<img style="text-align:center" src="https://s3.us-east-2.amazonaws.com/kepler-images/warrensbox/tfswitch/smallerlogo.png" alt="drawing" width="120" height="130"/>

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.

Documentation

Click here for our extended documentation.

NOTE

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.

Installation

tfswitch is available as a binary and on various package managers (eg. Homebrew).

Windows

Download 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.

Homebrew

For macOS or various Linux distributions, Homebrew offers the simplest installation process. <a href="https://brew.sh/" target="_blank">If you do not have homebrew installed, click here</a>.

brew install warrensbox/tap/tfswitch

Linux

Installation for Linux operating systems.

curl -L https://raw.githubusercontent.com/warrensbox/terraform-switcher/master/install.sh | bash

Arch User Repository (AUR) packages for Arch Linux

# compiled from source
yay tfswitch

# precompiled
yay tfswitch-bin

Install from source

Alternatively, you can install the binary from the source <a href="https://github.com/warrensbox/terraform-switcher/releases" target="_blank">here</a>.

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

Having trouble installing

Quick Start

Dropdown Menu

Execute tfswitch and select the desired Terraform version via the dropdown menu.

Version on command line

Use tfswitch 1.7.0 to install Terraform version 1.7.0. Replace the version number as required.

More usage guide here

How to contribute

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

Additional Info

See how to upgrade and uninstall or troubleshoot

Issues

Please open issues here: New Issue