HashiConf 2025 Don't miss the live stream of HashiConf Day 2 happening now View live stream

Install using a package manager

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.

The steps vary by Linux distribution.

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.

You can install the Boundary binary using a package manager, or manually install the binary and configure the Boundary service.

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

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

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

Update the package index:
```
$ sudo apt update
```
Install Boundary Enterprise:
```
$ sudo apt install boundary-enterprise
```

Use the following command to install yum-config-manager to manage your repositories:
```
$ sudo yum install -y yum-utils
```

Add the official HashiCorp Linux repository:

$ sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/RHEL/hashicorp.repo

Install Boundary Enterprise:

$ sudo yum -y install boundary-enterprise

Use the following command to install yum-config-manager to manage your repositories:
```
$ sudo yum install -y yum-utils shadow-utils
```

Add the official HashiCorp Linux repository:

$ sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/AmazonLinux/hashicorp.repo

Install Boundary Enterprise:

$ sudo yum -y install boundary-enterprise

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

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

Update the package index:
```
$ sudo apt update
```
Install Boundary Community Edition:
```
$ sudo apt install boundary
```

Use the following command to install yum-config-manager to manage your repositories:
```
$ sudo yum install -y yum-utils
```

Add the official HashiCorp Linux repository:

$ sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/RHEL/hashicorp.repo

Install Boundary Community Edition:
```
$ sudo yum -y install boundary
```

Use the following command to install yum-config-manager to manage your repositories:
```
$ sudo yum install -y yum-utils shadow-utils
```

Add the official HashiCorp Linux repository:

$ sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/AmazonLinux/hashicorp.repo

Install Boundary Community Edition:
```
$ sudo yum -y install boundary
```

Manually install Boundary

You can manually install a Boundary package from the HashiCorp Linux Repository, build Boundary from source, or get the package from another trusted location.

If you choose to install Boundary manually, ensure the Boundary packages you deploy on your controllers and workers in the next step are the same version. If you are deploying Boundary Enterprise, ensure you have a binary labeled ent.

You can review the following topics to manually configure systemd for the controllers and workers:

Next steps

After you install the binary, you should: