Skip to main content
In this lesson/article you will learn how to install Terraform on macOS and Linux. Recommended installation options covered here:
  • macOS — Homebrew (recommended)
  • Manual install — download a specific Terraform binary
  • Linux — Debian/Ubuntu (apt)
  • Linux — RHEL/CentOS/Amazon Linux (yum/dnf)
  • Automation-friendly installs using releases.hashicorp.com
If you are preparing for the HashiCorp Certified: Terraform Associate 004 exam, practice with Terraform 1.2 since the exam content focuses on that version. You do not always need the latest version for learning or exam prep.
Quick comparison of installation methods:
MethodBest forNotes / Link
Homebrew (macOS)macOS users who want a packaged installUses HashiCorp Homebrew tap
Manual (ZIP)Pinning an exact Terraform versionUse releases.hashicorp.com or HashiCorp downloads page
apt (Debian/Ubuntu)APT-based Linux distributionsAdds HashiCorp apt repository and GPG key
yum/dnf (RHEL/CentOS/Amazon Linux)RPM-based Linux distributionsAdd HashiCorp RPM repo and install with yum or dnf
Automated scripts / CINon-interactive installsDownload specific zip from releases.hashicorp.com and install binary
If you use macOS and have Homebrew installed, use the HashiCorp Homebrew tap for the simplest install: 
brew tap hashicorp/tap
brew install hashicorp/tap/terraform
This installs the latest Terraform from the tap. If you require a specific version (for example, Terraform 1.2.x) for exam practice, use the manual download instructions below to get the exact binary for your CPU/OS (darwin_amd64 or darwin_arm64).
The image shows a webpage from HashiCorp’s site displaying download options for Terraform, with separate sections for different operating systems like macOS and Windows.
Notes for Homebrew + Apple Silicon:
  • Homebrew installs to /opt/homebrew/bin on Apple Silicon and to /usr/local/bin on Intel macOS. Ensure the Homebrew bin path is in your PATH.

​
2) Download a specific Terraform version (manual install)

To pin a precise release (recommended for predictable exam/CI environments), download the platform-specific ZIP for the release you need from: After downloading the ZIP (it contains a single terraform executable):
  1. Unzip the archive.
  2. Move the terraform binary into a directory that appears in your PATH (example: /usr/local/bin or /opt/homebrew/bin).
  3. Make it executable (chmod +x if necessary).
  4. Verify the installation.
Example commands (macOS or Linux): 
# From your Downloads folder (adjust paths as needed)
cd ~/Downloads
unzip terraform_1.2.2_darwin_arm64.zip

# Move the binary to a directory in your PATH (use sudo if required)
sudo mv terraform /usr/local/bin/terraform
sudo chmod +x /usr/local/bin/terraform

# Verify installation
terraform version
which terraform
echo $PATH
When selecting the correct ZIP on the downloads page, pick the build that matches your CPU and OS: darwin_amd64, darwin_arm64, linux_amd64, linux_arm64, etc.
The image shows a computer screen with the HashiCorp Terraform download page open in a browser, alongside a file explorer window highlighting a "terraform" executable file and a "LICENSE.txt" file.
Expected example output after a correct manual install: 
$ terraform version
Terraform v1.2.2
on darwin_arm64

$ which terraform
/usr/local/bin/terraform
If terraform is not found after copying the binary, confirm the target directory is in your PATH (echo $PATH) and that the binary is executable (chmod +x terraform). Use which terraform to locate the active binary. When in doubt, remove older copies or adjust your PATH to prioritize the intended installation.

​
3) Linux — Debian / Ubuntu (apt)

HashiCorp maintains an apt repository for Debian/Ubuntu. To add the GPG key, register the repository, and install Terraform: 
# Add HashiCorp GPG key to a keyring
wget -O- https://apt.releases.hashicorp.com/gpg | gpg --dearmor | sudo tee /usr/share/keyrings/hashicorp-archive-keyring.gpg >/dev/null

# Add the repository (replace $(lsb_release -cs) with your distro codename if needed)
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

# Update and install terraform
sudo apt update && sudo apt install -y terraform
This installs the latest Terraform available in the HashiCorp apt repository. If you need a specific release version not available in the repo, use the manual ZIP install (see section 2).

​
4) Linux — RHEL / CentOS / Amazon Linux (yum / dnf)

For RPM-based distributions, enable the HashiCorp RPM repository and install via yum or dnf: 
# Add repo and install terraform
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/AmazonLinux/hashicorp.repo
sudo yum install -y terraform
If your distro uses dnf, replace yum with dnf. This approach installs the latest package available in HashiCorp’s RPM repository.

​
5) Using releases.hashicorp.com for automation

For scripted installs in CI/CD or automated provisioning, prefer the releases listing to fetch exact ZIP URLs directly (no interactive UI). Example release listing for a version like 1.2.2: 
terraform_1.2.2_SHA256SUMS
terraform_1.2.2_darwin_amd64.zip
terraform_1.2.2_darwin_arm64.zip
terraform_1.2.2_linux_386.zip
terraform_1.2.2_linux_amd64.zip
terraform_1.2.2_linux_arm.zip
terraform_1.2.2_linux_arm64.zip
...
Script approach (example pattern):
  1. Download the chosen ZIP from https://releases.hashicorp.com/terraform/<version>/terraform_<version>_<platform>.zip
  2. Unzip, move binary into a PATH directory, and set executable permissions.
This approach ensures reproducible installs across build agents and containers.

​
Quick troubleshooting

  • command not found after copying the binary:
    • Confirm the install directory is in your PATH (echo $PATH).
    • Confirm the binary is executable: chmod +x /path/to/terraform.
  • Multiple Terraform versions:
    • which terraform shows which binary will be executed. Remove or reorder binaries to control which version is active.
  • Permission errors:
    • Use sudo when moving or writing to system bin directories, or install to a user-writable directory and add it to your PATH.
Useful links and references: Go get Terraform downloaded — for the HashiCorp Certified: Terraform Associate 004 exam, download and use 1.2.x if you want to practice on the same major/minor release used by the exam. In the next lesson/article I’ll show you…

Watch Video