Configuration Automation - Ping CLI

Install

macOS

Homebrew package manager

Use Ping Identity’s Homebrew tap to install Ping CLI

brew install pingidentity/tap/pingcli

OR

brew tap pingidentity/tap
brew install pingcli

Manual installation

Use the following single-line command to install Ping CLI directly into /usr/local/bin.

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 for artifact downloads, artifact signatures, and the checksum file.

To verify package downloads, refer to the Verify Signatures section.

Windows

Manual installation

Use the following single-line PowerShell 7.4 command to install Ping CLI directly into %LOCALAPPDATA%\Programs.

$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}"
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 for artifact downloads, artifact signatures, and the checksum file.

To verify package downloads, refer to the Verify Signatures section.

Linux

Homebrew package manager

Use Ping Identity’s Homebrew tap to install Ping CLI

brew install pingidentity/tap/pingcli

OR

brew tap pingidentity/tap
brew install pingcli

Alpine package (.apk)

You can find Alpine (.apk) package downloads in the latest release on GitHub. To verify package downloads, refer to the Verify Signatures section.

apk add --allow-untrusted pingcli_<version>_linux_amd64.apk
apk add --allow-untrusted pingcli_<version>_linux_arm64.apk

Debian/Ubuntu package (.deb)

You can find Debian (.deb) package downloads in the latest release on GitHub. To verify package downloads, refer to the Verify Signatures section.

apt-get install pingcli_<version>_linux_amd64.deb
apt-get install pingcli_<version>_linux_arm64.deb

CentOS/Fedora/RHEL package (.rpm)

You can find RPM (.rpm) package downloads in the latest release on GitHub. To verify package downloads, refer to the Verify Signatures section.

yum install pingcli_<version>_linux_amd64.rpm
yum install pingcli_<version>_linux_arm64.rpm
dnf install pingcli_<version>_linux_amd64.rpm
dnf install pingcli_<version>_linux_arm64.rpm

Manual installation

Use the following single-line command to install Ping CLI directly into '/usr/local/bin'.

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 for artifact downloads, artifact signatures, and the checksum file.

To verify package downloads, refer to the Verify Signatures section.

Docker

Use the Ping CLI Docker image

Pull Image:

docker pull pingidentity/pingcli:latest

Test the installation:

docker run pingidentity/pingcli:latest --version

Verify signatures

Checksums

You can find the checksums.txt file in the latest GitHub release. The checksums are in the format of SHA256.

GPG signatures

See the latest GitHub release for the artifact downloads and signature files.

Add our public GPG key using OpenPGP public key server

gpg --keyserver keys.openpgp.org --recv-key 0x6703FFB15B36A7AC

Add our public GPG key using MIT PGP public key server

gpg --keyserver keys.openpgp.org --recv-key 0x6703FFB15B36A7AC

Verify artifact via signature file

gpg --verify <artifact-name>.sig <artifact-name>

More information