---
title: Install and update on macOS
description: Ping CLI is available for macOS using Homebrew and as a standalone binary download. Choose the installation method that best fits your environment. Homebrew is the recommended installation method for macOS users.
component: pingcli
version: 1.0
page_id: pingcli:install:macos
canonical_url: https://developer.pingidentity.com/pingcli/1.0/install/macos.html
revdate: June 5, 2026
section_ids:
  verify-the-installation: Verify the installation
  compatibility: Compatibility
  upgrading-the-cli-binary: Upgrading the CLI binary
  configuration-migration: Configuration migration
  uninstalling-ping-cli: Uninstalling Ping CLI
  removing-configuration-files-optional: Removing configuration files (optional)
  next-steps: Next steps
---

# Install and update on macOS

Ping CLI is available for macOS using Homebrew and as a standalone binary download. Choose the installation method that best fits your environment. Homebrew is the recommended installation method for macOS users.

* Homebrew

* Manual

The easiest way to install Ping CLI on macOS is using Homebrew. Homebrew will automatically handle platform detection (Intel or Apple Silicon) and install the appropriate binary.

Install Ping CLI:

```console
brew install pingidentity/tap/pingcli
```

Alternatively, add the tap explicitly first:

```console
brew tap pingidentity/tap
brew install pingcli
```

To view Ping CLI's installation details:

```console
brew info pingidentity/tap/pingcli
```

If you prefer not to use Homebrew, you can download and install Ping CLI directly into `/usr/local/bin` using this single-line command:

```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; \
chmod +x /usr/local/bin/pingcli
```

To install a specific version, visit [the GitHub releases page](https://github.com/pingidentity/pingcli/releases) and download the binary you need.

## Verify the installation

After installation, verify that Ping CLI is properly installed by checking its version:

```console
pingcli --version
```

You should see output similar to:

```console
pingcli version 1.0.0
```

## Compatibility

Ping CLI is available for both Intel and Apple Silicon (ARM64) processors. Homebrew automatically detects your system architecture and installs the appropriate version.

## Upgrading the CLI binary

When you upgrade Ping CLI, your existing configuration files are automatically migrated to the new format on first run. This process is safe and includes automatic backups.

* Homebrew

* Manual

If you installed Ping CLI using Homebrew, upgrading is straightforward:

```console
brew upgrade pingcli
```

Then verify the upgrade:

```console
pingcli --version
```

If you installed Ping CLI manually, download the new binary from [the latest GitHub release](https://github.com/pingidentity/pingcli/releases/latest) and replace the existing binary:

```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; \
chmod +x /usr/local/bin/pingcli
```

### Configuration migration

When you run Ping CLI after upgrading, the tool automatically detects the old configuration format and creates a migration plan. If you're running interactively, you'll be prompted to approve the migration. The CLI will:

1. Back up your existing config file (with a timestamp, for example, `config.yaml.backup.20260605T123456Z`).

2. Show you what changes will be made.

3. Apply the migration safely (atomic write).

For non-interactive environments (CI/CD scripts), set the following environment variable to auto-approve migration:

```console
export PINGCLI_CONFIG_MIGRATION_POLICY=yes
```

Then run your Ping CLI command as usual.

## Uninstalling Ping CLI

* Homebrew

* Manual

If you installed Ping CLI using Homebrew:

```console
brew uninstall pingcli
```

If you installed Ping CLI manually:

```console
rm /usr/local/bin/pingcli
```

### Removing configuration files (optional)

Ping CLI configuration files are stored in your user's home directory and are not automatically removed when you uninstall the binary. To manually remove them:

```console
rm -rf ~/.pingcli
```

## Next steps

Now that Ping CLI is installed, proceed to:

* [Configuration settings](../settings_reference/configuration-settings-reference.html) — Learn how to configure Ping CLI

* [Connect Ping Identity services](../using_pingcli/connecting-ping-services.html) — Set up connections to your Ping Identity products