HashiConf 2024 Now streaming live from Boston! Attend for free
Boundary
Boundary Home

You are viewing documentation for version v0.13.x. View latest version.

Install Boundary

This guide outlines the required steps to manually install and configure a single HashiCorp Boundary cluster as defined in the Recommended architecture topic. It assumes you install Boundary on virtual machines (VMs) or bare-metal servers running a Debian or Red Hat-based Linux distribution.

This document includes general guidance as well as specific recommendations for popular cloud infrastructure platforms. These recommendations have also been encoded into official Terraform reference architectures for AWS, Azure, and GCP.

Pre-built Boundary packages are available from the HashiCorp Linux Repository. In addition to installing the Boundary binary, the official package also provides a systemd service unit, and a local boundary user account under which the service runs.

You must complete the following steps for each Boundary controller and worker node that you want to deploy. The binary operates as either a worker or controller, depending on the subsequent configuration that you generate for the Boundary binary.

The steps vary by Linux distribution. Select your distribution, and complete the steps to install Boundary.

  1. Use the following command to add the HashiCorp GPC key as a trusted package-signing key:

    $ curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo apt-key add -

  2. Add the official HashiCorp Linux repository:

    $ sudo apt-add-repository "deb [arch=amd64] https://apt.releases.hashicorp.com $(lsb_release -cs) main"

  3. Update the package index:

    $ sudo apt update

  4. Install Boundary:

    $ sudo apt install boundary