Install HCP CLI

The hcp CLI is available as a pre-compiled binary or as a package for several operating systems.

Homebrew is a free and open source package management system for Mac OS X. Install the official hcp CLI formula from the terminal.

Install the HashiCorp tap, a repository of all of the HashiCorp Homebrew packages.
```
$ brew tap hashicorp/tap
```
Install hcp with hashicorp/tap/hcp.
```
$ brew install hashicorp/tap/hcp
```
Note
This installs a signed binary and is automatically updated with every new official release.
Run brew upgrade to upgrade to the latest version.
```
$ brew upgrade hashicorp/tap/hcp
```

HashiCorp officially maintains and signs packages for the following Linux distributions.

Install the required packages.

$ sudo apt-get update && \
  sudo apt-get install wget gpg coreutils

Add the HashiCorp GPG key.

$ wget -O- 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 and install.

$ sudo apt-get update && sudo apt-get install hcp

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

Update and install.

$ sudo yum -y update && sudo yum -y install hcp

Install dnf config-manager to manage your repositories.
```
$ sudo dnf install -y dnf-plugins-core
```

Add the official HashiCorp Linux repository.

$ sudo dnf config-manager --add-repo https://rpm.releases.hashicorp.com/fedora/hashicorp.repo

Update and install.

$ sudo dnf -y update && sudo dnf -y install hcp

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/AmazonLinux/hashicorp.repo

Update and install.

$ sudo yum -y update && sudo yum -y install hcp

Verify the installation

Verify the HCP CLI was installed correctly with the hcp command. This will return a list of commands and flags you can interact with.

$ hcp
USAGE
  hcp <command> [Optional Flags]

DESCRIPTION
  The HCP Command Line Interface is a unified tool to manage your HCP services.

COMMAND GROUPS
  auth:           Authenticate to HCP.
  iam:            Identity and access management.
  organizations:  Interact with an existing organization.
  profile:        View and edit HCP CLI properties.
  projects:       Create and manage projects.
  waypoint:       Manage Waypoint.

COMMANDS
  version:  Display the HCP CLI version.

GLOBAL FLAGS
  --debug
    Enable debug output.

  --format=FORMAT
    Sets the output format.

  --profile=NAME
    The profile to use. If omitted, the currently selected profile will be used.

  --project=ID
    The HCP Project ID to use. If omitted the current project set in the
    configuration is used.

  --quiet
    Minimizes output.

Install tab autocomplete

Note

If you installed the CLI using one of the Linux packages, it will have automatically installed autocomplete.

Install autocompletion for the HCP CLI.

$ hcp -autocomplete-install

For the autocomplete to take effect, either create a new terminal session or source your terminal configuration.

To uninstall autocompletion for the HCP CLI, use -autocomplete-uninstall.

$ hcp -autocomplete-uninstall