Install the HCP CLI

The hcp CLI lets you administer HashiCorp Cloud Platform (HCP) resources and services. You can interact with hcp directly or integrate it in scripts to automate your workflows. The HCP CLI is available across most platforms and lets you efficiently execute common platform tasks and manage HCP resources at scale.

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][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

HashiCorp does not maintain installation binaries using Chocolatey or Scoop. The latest version of the HCP Vault Secrets CLI is available by manual installation.

This example downloads the Windows AMD64 binary using PowerShell. Use a Windows account with appropriate permissions to extract the binary to the Program Files directory and update the PATH.

Launch a PowerShell terminal using Run as Administrator. If prompted, click Yes.

Download the zip archive to the current working directory.

$ Invoke-WebRequest -URI https://releases.hashicorp.com/hcp/0.3.0/hcp_0.3.0_windows_amd64.zip`
   -OutFile hcp_0.3.0_windows_amd64.zip

Unzip the file.

$ Expand-Archive -Path .\hcp_0.3.0_windows_amd64.zip -Destination `C:\Program Files\HashiCorp\hcp\bin\`

Update the $PATH environment variable.

$ $Env:path = $env:path + ";C:\Program Files\HashiCorp\hcp\bin"

Verify the hcp binary is available.

$ 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.

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.