Official Packaging Guide

Last updated: July 31, 2024

Overview

HashiCorp provides a variety of Official Release Channels. If you use apt for package management on Linux distributions such as Ubuntu or Debian, refer to the debian package repository section below. If you use yum or dnf for package management on Linux distributions such as CentOS, RHEL, Fedora, or AmazonLinux, refer to the rpm package repository section below. If you use homebrew for package management on macos or linux, refer to the homebrew tap section below.

For a more detailed tutorial on how to verify a Hashicorp product download, please refer to our Well-Architected Framework documentation.

Supported Distributions

Note: Not all products are pre-packaged for all target architectures. If packages are not available for your architecture, refer to releases.hashicorp.com for additional builds.

debian package repository

Supported distributions: Ubuntu, Debian

GPG is required for the package signing key

sudo apt update && sudo apt install gpg

Download the signing key to a new keyring

wget -O- https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg

Verify the key's fingerprint

gpg --no-default-keyring --keyring /usr/share/keyrings/hashicorp-archive-keyring.gpg --fingerprint

The fingerprint must match 798A EC65 4E5C 1542 8C8E 42EE AA16 FCBC A621 E701, which can also be verified at https://www.hashicorp.com/security under "Linux Package Checksum Verification". Please note that there was a previous signing key used prior to January 23, 2023, which had the fingerprint E8A0 32E0 94D8 EB4E A189 D270 DA41 8C88 A321 9F7B. Details about this change are available on the status page: https://status.hashicorp.com/incidents/fgkyvr1kwpdh, https://status.hashicorp.com/incidents/k8jphcczkdkn.

Add the HashiCorp repo

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(grep -oP '(?<=UBUNTU_CODENAME=).*' /etc/os-release || lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list

apt update!

sudo apt update

To see all available packages, you can run: 

grep ^Package: /var/lib/apt/lists/apt.releases.hashicorp.com*Packages | sort -u

Install a product

sudo apt install consul

[Optional] Enable the test repo for prerelease versions

echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) test" | sudo tee /etc/apt/sources.list.d/hashicorp.list

Having trouble?

Submit an issue on the relevant product's GitHub repo, or at https://discuss.hashicorp.com.

rpm package repository

Supported Distributions: RHEL, CentOS, Fedora, Amazon Linux

Add the HashiCorp repo

Note: The provided repository configuration covers the supported distributions listed above. If you are using a variant not listed, you are encouraged to modify the repository configuration to suit your needs. For example, users of RHEL 7Server or RHEL 8.3 can change the baseurl to use 7 or 8 respectively in place of the $releasever variable.

RHEL/CentOS

wget -O- https://rpm.releases.hashicorp.com/RHEL/hashicorp.repo | sudo tee /etc/yum.repos.d/hashicorp.repo

Fedora

wget -O- https://rpm.releases.hashicorp.com/fedora/hashicorp.repo | sudo tee /etc/yum.repos.d/hashicorp.repo

Amazon Linux

wget -O- https://rpm.releases.hashicorp.com/AmazonLinux/hashicorp.repo | sudo tee /etc/yum.repos.d/hashicorp.repo

List available packages

sudo yum list available | grep hashicorp

Install a product

sudo yum install consul

[Optional] Enable the test repo for prerelease versions

Edit the repo file at /etc/yum.repos.d/hashicorp.repo and set enabled=1 for [hashicorp-test]

Having trouble?

Submit an issue on the relevant product's GitHub repo, or at https://discuss.hashicorp.com.

Homebrew tap

Supported Platforms: MacOS, Linux

Add the HashiCorp tap

brew tap hashicorp/tap

List available formulae and casks

brew tap-info hashicorp/tap --json | jq -r '.[]|(.formula_names[],.cask_tokens[])'

Install a product

brew install hashicorp/tap/consul

Having trouble?

Submit an issue at https://github.com/hashicorp/homebrew-tap/issues.

Linux OS End-of-Life Policy

HashiCorp announced in this blogpost that we will no longer support Linux distributions that have reached End-of-Life (EoL) status starting on/before January 10th, 2024. Moving forward, we will remove EoL linux versions/releases from {deb|rpm}.releases.hashicorp.com on a regular basis. We will follow the EoL cycles of each distribution and we will remove support when the distribution OS/version reaches an EoL status announced by the distribution maintainers (Fedora, Debian, RHEL, and Ubuntu). We strongly encourage our users to routinely upgrade to actively maintained versions of Linux OSes or utilize packages on the Archive Site for deprecated versions to avoid disruptions.