tfenv

Terraform version manager inspired by rbenv

Support

Currently tfenv supports the following OSes

• Mac OS X (64bit)
• Linux (64bit)
• Windows (64bit) - only tested in git-bash

Installation

1. Check out tfenv into any path (here is ${HOME}/.tfenv)

$ git clone https://github.com/kamatama41/tfenv.git ~/.tfenv

2. Add ~/.tfenv/bin to your $PATH any way you like

$ echo 'export PATH="$HOME/.tfenv/bin:$PATH"' >> ~/.bash_profile

OR you can make symlinks for tfenv/bin/* scripts into a path that is already added to your $PATH (e.g. /usr/local/bin) OSX/Linux Only!

ln -s ~/.tfenv/bin/* /usr/local/bin

Usage

tfenv install

Install a specific version of Terraform
latest is a syntax to install latest version

$ tfenv install 0.7.0
$ tfenv install latest

If you use .terraform-version, tfenv install (no argument) will install the version written in it.

tfenv use

Switch a version to use

$ tfenv use 0.7.0

tfenv list

List installed versions

% tfenv list
0.7.0
0.7.0-rc4
0.6.16
0.6.2
0.6.1

tfenv list-remote

List installable versions

% tfenv list-remote
0.7.0
0.7.0-rc4
0.7.0-rc3
0.7.0-rc2
0.7.0-rc1
0.6.16
0.6.15
0.6.14
0.6.13
...

.terraform-version

If you put .terraform-version file on your project root, tfenv detects it and use the version written in it.

$ cat .terraform-version
0.6.16

$ terraform --version
Terraform v0.6.16

Your version of Terraform is out of date! The latest version
is 0.7.3. You can update by downloading from www.terraform.io

$ echo 0.7.3 > .terraform-version

$ terraform --version
Terraform v0.7.3

Upgrading

$ git --git-dir=~/.tfenv/.git pull

Uninstalling

$ rm -rf /some/path/to/tfenv

LICENSE

• tfenv itself
• rbenv
  • tfenv partially uses rbenv's source code