Official Packaging Guide
Last updated: January 26, 2023
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.
Supported Distributions
Distro | Versions |
---|---|
Ubuntu | Xenial, Bionic, Focal, Groovy, Hirsute, Impish, Jammy, Kinetic, Lunar |
Debian | Jessie, Stretch, Buster, Bullseye, Bookworm |
Fedora | 33, 34, 35, 36, 37, 38, 39 |
RHEL/CentOS | 7, 8, 9 |
AmazonLinux | 2, latest |
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 $(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
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.