Installation

tfswitch is available for macOS, Linux and Windows based operating systems.

Homebrew

Installation for macOS or Linux (where supported) is the easiest with Homebrew. If you do not have Homebrew installed, click here.

⚠ Homebrew on Linux (formerly referred to as Linuxbrew) requires at least Homebrew v5.0.6 (released Dec 16, 2025)

brew install tfswitch

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/tfswitch

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

Linux

Installation for Linux operating systems.

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

By default installer script will try to download tfswitch binary into /usr/local/bin
To install at custom path use below:

curl -L https://raw.githubusercontent.com/warrensbox/terraform-switcher/master/install.sh | bash -s -- -b $HOME/.local/bin

By default installer script will try to download latest version of tfswitch binary
To install custom (not latest) version use:

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

Both options can be combined though:

curl -L https://raw.githubusercontent.com/warrensbox/terraform-switcher/master/install.sh | bash -s -- -b $HOME/.local/bin 1.1.1

Arch User Repository (AUR) packages for Arch Linux

# compiled from source
yay tfswitch

# precompiled
yay tfswitch-bin

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.

Install from source

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.

Having trouble installing.