Install Boundary clients

Boundary end users access infrastructure targets using the Boundary Desktop Client app or the Boundary CLI. Enterprise or HCP Boundary users can use transparent sessions to proxy traffic through the Boundary Client Agent ^HCP/ENT.

This guide outlines the required steps to manually install and configure a Boundary client depending on which distribution of Boundary end users access.

To learn about installing the Boundary binary when you deploy Boundary controllers or workers, refer to the Install Boundary page.

Select your Boundary distribution, and complete the steps to install the correct clients:

Enterprise

This feature requires Boundary Enterprise.

The Boundary installer bundles together the following components:

Boundary binary (CLI)
Boundary Desktop Client app
Boundary Client Agent ^HCP/ENT

Download the appropriate Boundary installer for your Windows, MacOS, or Linux environment from the Install Boundary downloads page or the releases page.

The Client Agent does not have a standalone binary, so you must use the Boundary installer to install or update it. You can download the Boundary binary or Desktop Client app individually, but compatibility is not guaranteed. Refer to the Supported versions policy to learn more.

The Client Agent and the installer use the same major number as the current Boundary release. However, the installer's minor number may differ if an update is released for the Client Agent only. For example, the current Boundary release may be version 0.21.1, but the Boundary installer could be version 0.21.2.

Refer to the Transparent sessions interoperability matrix for a list of third-party products that have been tested and confirmed to work with the Boundary Client Agent to provide transparent sessions.

Warning

Before you launch the Boundary installer, ensure that you have uninstalled all previous versions of the Boundary binary and Boundary Desktop Client app.

To learn more about installing the Boundary CLI and Boundary Desktop Client app, refer to the Get started with HCP Boundary tutorials.

We recommend the following components for end users:

Boundary binary (CLI)
Boundary Desktop Client app

Download these components for your Windows, MacOS, or Linux environment from the Install Boundary downloads page or the HashiCorp releases page.

Client compatibility is not guaranteed. You should always ensure that your client is compatible with the version of the Boundary control plane you connect to. Refer to the Supported versions policy to learn more.

To learn more about installing the Boundary CLI and Boundary Desktop Client app, refer to the Get started with self-managed Boundary tutorials.