How to Install Terraform on Any OS (2026 Guide)

To install Terraform, add HashiCorp's official package repository for your OS, then run apt install terraform, dnf install terraform, or brew install hashicorp/tap/terraform. This page is the hub for installing Terraform on any operating system — pick your platform from the directory below for a full step-by-step guide, or use the quick commands here to get running in under a minute.

Quick Install (TL;DR)

Terraform is distributed by HashiCorp through official package repositories and as a standalone binary. The fastest path depends on your OS:

# macOS (Homebrew)
brew tap hashicorp/tap && brew install hashicorp/tap/terraform
 
# Debian / Ubuntu (apt)
wget -O- https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
sudo apt update && sudo apt install terraform
 
# RHEL / Fedora / Rocky / AlmaLinux (dnf)
sudo dnf install -y dnf-plugins-core
sudo dnf config-manager --add-repo https://rpm.releases.hashicorp.com/fedora/hashicorp.repo
sudo dnf install terraform

Then confirm the install:

terraform --version

You should see Terraform v1.12+ on linux_amd64, darwin_arm64, or your matching platform.

Which install method should I use?

• Official package manager (recommended). Using HashiCorp's apt/dnf/brew repositories means apt upgrade, dnf upgrade, or brew upgrade keeps Terraform current alongside the rest of your system. Best for workstations and CI runners.
• Version manager (tfenv). Teams that pin Terraform per project should use tfenv with a .terraform-version file so everyone runs the exact same version.
• Manual binary. On distros without a HashiCorp repo (Alpine, Void, Gentoo, Slackware, NixOS), download the official zip, verify the checksum, and drop the binary in /usr/local/bin. Each guide below shows the exact steps.
• Docker. For ephemeral or sandboxed runs, the Docker image avoids touching the host at all.

Verify your installation

After installing on any platform, run a quick smoke test:

terraform -help        # confirms the binary is on your PATH
terraform version      # prints the version and provider info

If terraform: command not found appears, the binary is not on your PATH. Reopen your shell or add the install directory (for example /usr/local/bin) to PATH.

Install Terraform by platform

Choose your operating system or distribution for a complete, tested walkthrough including repository setup, verification, and troubleshooting.

Debian & Ubuntu

• Install Terraform on Ubuntu (overview)
• Install Terraform on Ubuntu 20.04
• Install Terraform on Ubuntu 22.04
• Install Terraform on Ubuntu 24.04
• Install Terraform on Ubuntu 25.04
• Install Terraform on Pop!_OS 24.04
• Install Terraform on Debian 11
• Install Terraform on Debian 12
• Install Terraform on Debian 13
• Install Terraform on Debian (apt)
• Install Terraform on Linux Mint 21
• Install Terraform on Linux Mint 22
• Install Terraform on elementary OS 7
• Install Terraform on Zorin OS 17
• Install Terraform on MX Linux
• Install Terraform on Kali Linux
• Install Terraform on Raspberry Pi OS

RHEL, Fedora & RPM

• Install Terraform on RHEL (overview)
• Install Terraform on RHEL 8
• Install Terraform on RHEL 9
• Install Terraform on RHEL 10
• Install Terraform on CentOS 7
• Install Terraform on CentOS Stream 9
• Install Terraform on CentOS Stream 10
• Install Terraform on Rocky Linux 8
• Install Terraform on Rocky Linux 9
• Install Terraform on Rocky Linux 10
• Install Terraform on AlmaLinux 8
• Install Terraform on AlmaLinux 9
• Install Terraform on AlmaLinux 10
• Install Terraform on Oracle Linux 8
• Install Terraform on Oracle Linux 9
• Install Terraform on Oracle Linux 10
• Install Terraform on Fedora 41
• Install Terraform on Fedora 42
• Install Terraform on Fedora 43
• Install Terraform on Fedora 44
• Install Terraform on Amazon Linux 2023

Arch & openSUSE

• Install Terraform on Arch Linux
• Install Terraform on Manjaro
• Install Terraform on EndeavourOS
• Install Terraform on Garuda Linux
• Install Terraform on openSUSE Leap 15
• Install Terraform on openSUSE Tumbleweed

Other Linux & BSD

• Install Terraform on Alpine Linux
• Install Terraform on Void Linux
• Install Terraform on Gentoo
• Install Terraform on Slackware
• Install Terraform on NixOS
• Install Terraform on FreeBSD

macOS, Windows & tooling

• Install Terraform on macOS (Homebrew)
• Install Terraform on Windows
• Install Terraform on Windows WSL2
• Install Terraform with Docker
• Manage versions with tfenv

Frequently asked questions

How do I install Terraform on Linux?

Add HashiCorp's official repository for your distribution, then install with your package manager: apt install terraform on Debian/Ubuntu, or dnf install terraform on RHEL/Fedora/Rocky/AlmaLinux. On distributions without a HashiCorp repo, download the official binary and place it on your PATH. Each platform guide above has the exact commands.

What is the easiest way to install Terraform?

On macOS, Homebrew (brew install hashicorp/tap/terraform) is the quickest. On Linux, the official apt or dnf repository is easiest because upgrades come through your normal system updates.

How do I check that Terraform installed correctly?

Run terraform --version. It prints the installed version and platform. If you see command not found, the binary is not on your PATH.

How do I install a specific Terraform version?

Use tfenv to install and switch between versions, or download the exact version's binary from HashiCorp's releases. Package managers install the latest stable release by default.

Next steps

Once Terraform is installed, get hands-on:

• Getting started with Terraform on AWS
• Terraform commands overview
• Manage Terraform versions with tfenv
• Compare Terraform to alternatives (OpenTofu, Pulumi, Ansible)

Hands-On Courses

Learn by doing with interactive courses on CopyPasteLearn:

• Terraform for Beginners course on CopyPasteLearn