--- title: Install description: Use Ping Identity's Homebrew tap to install Ping CLI component: pingcli page_id: pingcli::install-pingcli canonical_url: https://developer.pingidentity.com/pingcli/install-pingcli.html revdate: March 23, 2025 section_ids: macos: macOS homebrew-package-manager: Homebrew package manager manual-installation: Manual installation windows: Windows manual-installation-2: Manual installation linux: Linux homebrew-package-manager-2: Homebrew package manager apk-package: Alpine package (.apk) deb-package: Debian/Ubuntu package (.deb) rpm-package: CentOS/Fedora/RHEL package (.rpm) manual-installation-3: Manual installation docker: Docker verify-signatures: Verify signatures checksums: Checksums gpg-signatures: GPG signatures add-public-gpg-key-openpgp: Add our public GPG key using OpenPGP public key server add-public-gpg-key-mit-pgp: Add our public GPG key using MIT PGP public key server verify-artifact-via-signature-file: Verify artifact via signature file more-information: More information --- # Install ## macOS ### Homebrew package manager Use Ping Identity's Homebrew tap to install Ping CLI ```console brew install pingidentity/tap/pingcli ``` OR ```console brew tap pingidentity/tap brew install pingcli ``` ### Manual installation Use the following single-line command to install Ping CLI directly into `/usr/local/bin`. ```console RELEASE_VERSION=$(basename $(curl -Ls -o /dev/null -w %{url_effective} https://github.com/pingidentity/pingcli/releases/latest)); \ OS_NAME=$(uname -s); \ HARDWARE_PLATFORM=$(uname -m | sed s/aarch64/arm64/ | sed s/x86_64/amd64/); \ URL="https://github.com/pingidentity/pingcli/releases/download/${RELEASE_VERSION}/pingcli_${RELEASE_VERSION#v}_${OS_NAME}_${HARDWARE_PLATFORM}"; \ curl -Ls -o pingcli "${URL}"; \ mv pingcli /usr/local/bin/pingcli; ``` To install a custom version, refer to [the latest release on GitHub](https://github.com/pingidentity/pingcli/releases/latest) for artifact downloads, artifact signatures, and the checksum file. To verify package downloads, refer to the [Verify Signatures](#verify-signatures) section. ## Windows ### Manual installation Use the following single-line PowerShell 7.4 command to install Ping CLI directly into `%LOCALAPPDATA%\Programs`. ```powershell $latestReleaseUrl = Invoke-WebRequest -Uri "https://github.com/pingidentity/pingcli/releases/latest" -MaximumRedirection 0 -ErrorAction Ignore -UseBasicParsing -SkipHttpErrorCheck; ` $RELEASE_VERSION = [System.IO.Path]::GetFileName($latestReleaseUrl.Headers.Location); ` $RELEASE_VERSION_NO_PREFIX = $RELEASE_VERSION -replace "^v", ""; ` $HARDWARE_PLATFORM = $env:PROCESSOR_ARCHITECTURE -replace "ARM64", "arm64" -replace "x86", "386" -replace "AMD64", "amd64" -replace "EM64T", "amd64"; ` $URL = "https://github.com/pingidentity/pingcli/releases/download/${RELEASE_VERSION}/pingcli_${RELEASE_VERSION_NO_PREFIX}_windows_${HARDWARE_PLATFORM}.exe" Invoke-WebRequest -Uri $URL -OutFile "pingcli.exe"; ` Move-Item -Path pingcli.exe -Destination "${env:LOCALAPPDATA}\Programs" ``` To install a custom version, refer to [the latest release on GitHub](https://github.com/pingidentity/pingcli/releases/latest) for artifact downloads, artifact signatures, and the checksum file. To verify package downloads, refer to the [Verify Signatures](#verify-signatures) section. ## Linux ### Homebrew package manager Use Ping Identity's Homebrew tap to install Ping CLI ```console brew install pingidentity/tap/pingcli ``` OR ```console brew tap pingidentity/tap brew install pingcli ``` ### Alpine package (.apk) You can find Alpine (.apk) package downloads in [the latest release on GitHub](https://github.com/pingidentity/pingcli/releases/latest). To verify package downloads, refer to the [Verify Signatures](#verify-signatures) section. ```console apk add --allow-untrusted pingcli__linux_amd64.apk apk add --allow-untrusted pingcli__linux_arm64.apk ``` ### Debian/Ubuntu package (.deb) You can find Debian (.deb) package downloads in [the latest release on GitHub](https://github.com/pingidentity/pingcli/releases/latest). To verify package downloads, refer to the [Verify Signatures](#verify-signatures) section. ```console apt-get install pingcli__linux_amd64.deb apt-get install pingcli__linux_arm64.deb ``` ### CentOS/Fedora/RHEL package (.rpm) You can find RPM (.rpm) package downloads in [the latest release on GitHub](https://github.com/pingidentity/pingcli/releases/latest). To verify package downloads, refer to the [Verify Signatures](#verify-signatures) section. ```console yum install pingcli__linux_amd64.rpm yum install pingcli__linux_arm64.rpm dnf install pingcli__linux_amd64.rpm dnf install pingcli__linux_arm64.rpm ``` ### Manual installation Use the following single-line command to install Ping CLI directly into '/usr/local/bin'. ```console RELEASE_VERSION=$(basename $(curl -Ls -o /dev/null -w %{url_effective} https://github.com/pingidentity/pingcli/releases/latest)); \ OS_NAME=$(uname -s); \ HARDWARE_PLATFORM=$(uname -m | sed s/aarch64/arm64/ | sed s/x86_64/amd64/); \ URL="https://github.com/pingidentity/pingcli/releases/download/${RELEASE_VERSION}/pingcli_${RELEASE_VERSION#v}_${OS_NAME}_${HARDWARE_PLATFORM}"; \ curl -Ls -o pingcli "${URL}"; \ mv pingcli /usr/local/bin/pingcli; ``` To install a custom version, refer to [the latest release on GitHub](https://github.com/pingidentity/pingcli/releases/latest) for artifact downloads, artifact signatures, and the checksum file. To verify package downloads, refer to the [Verify Signatures](#verify-signatures) section. ## Docker Use the [Ping CLI Docker image](https://hub.docker.com/r/pingidentity/pingcli) Pull Image: ```console docker pull pingidentity/pingcli:latest ``` Test the installation: ```console docker run pingidentity/pingcli:latest --version ``` ## Verify signatures ### Checksums You can find the checksums.txt file in [the latest GitHub release](https://github.com/pingidentity/pingcli/releases/latest). The checksums are in the format of SHA256. ### GPG signatures See [the latest GitHub release](https://github.com/pingidentity/pingcli/releases/latest) for the artifact downloads and signature files. #### Add our public GPG key using OpenPGP public key server ```console gpg --keyserver keys.openpgp.org --recv-key 0x6703FFB15B36A7AC ``` #### Add our public GPG key using MIT PGP public key server ```console gpg --keyserver keys.openpgp.org --recv-key 0x6703FFB15B36A7AC ``` #### Verify artifact via signature file ```console gpg --verify .sig ``` ## More information * [CLI Configuration](general/cli-configuration.html) * [Connecting Ping Identity Services](general/cli-configuration-connecting-ping-services.html) * [Exporting Platform Configuration](general/exporting-platform-configuration.html) * [Making API Requests](general/making-api-requests.html) * [Command Reference](command_reference/pingcli.html) * [Ping CLI on GitHub](https://github.com/pingidentity/pingcli)