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.