Introduction
In this article, we will go over how to install a HCP-specific boundary worker binary manually and on a few Linux distributions.
Manual
To install the HCP-specific boundary worker binary, find the appropriate package for your system and download it. Boundary-worker is packaged as a zip archive.
After downloading Boundary-worker, unzip the package. Boundary-worker runs as a single binary namedboundary-worker
. Any other files in the package can be safely removed and Boundary-worker will still function.
The final step is to make sure that theboundary-worker
binary is available on thePATH
. See this page for instructions on setting the PATH on Linux and Mac. This page contains instructions for setting the PATH on Windows.
Linux
This will download the latest version of the HCP-specific boundary worker binary.
Ubuntu/Debian
wget -O- https://apt.releases.hashicorp.com/gpg | gpg --dearmor | sudo tee /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 boundary-worker-hcp
CentOS/RHEL
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/RHEL/hashicorp.repo
sudo yum -y install boundary-worker-hcp
Amazon Linux
sudo yum install -y yum-utils shadow-utils
sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/AmazonLinux/hashicorp.repo
sudo yum -y install boundary-worker-hcp
Note:
For self-managed worker registration with HCP Boundary, The binary version should match the version of the HCP control plane. Check the version of the control plane in the HCP Boundary portal, if the version installed from above doesn't match, download the appropriate version using wget. The example below installs the 0.10.5 version of the boundary-worker binary on Debian/Ubuntu.
wget -q https://releases.hashicorp.com/boundary-worker/0.10.5+hcp/boundary-worker_0.10.5+hcp_linux_amd64.zip ;\
sudo apt-get update && sudo apt-get install unzip ;\
unzip *.zip