HashiConf 2025 Don't miss the live stream of HashiConf Day 1 happening now. View live stream
Boundary
Boundary Home

Install Boundary

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.

Note

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 configuration that you generate for the Boundary binary.

The steps vary by Linux distribution.

Select your distribution of Boundary, and complete the steps to install the binary:

  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 gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg

  2. Add the official HashiCorp Linux repository:

    $ 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

  3. Update the package index:

    $ sudo apt update

  4. Install Boundary Enterprise:

    $ sudo apt install boundary-enterprise

You should install the binary on the controller and worker instances you configure to run in your Boundary environments.

Next steps

After you install the binary, you should:

  1. Configure controllers
  2. Deploy workers
  3. Initialize Boundary
  4. Install the Boundary Clients
Edit this page on GitHub