---
title: Run as a Docker container
description: Ping CLI is available as a Docker image, allowing you to run it in containerized environments without installing it directly on your system.
component: pingcli
version: 1.0
page_id: pingcli:install:docker
canonical_url: https://developer.pingidentity.com/pingcli/1.0/install/docker.html
revdate: June 5, 2026
section_ids:
  before-you-begin: Before you begin
  pull-the-ping-cli-docker-image: Pull the Ping CLI Docker image
  verify-the-installation: Verify the installation
  running-ping-cli-in-docker: Running Ping CLI in Docker
  basic-usage: Basic usage
  interactive-shell: Interactive shell
  mounting-local-directories: Mounting local directories
  using-ping-cli-in-cicd-pipelines: Using Ping CLI in CI/CD pipelines
  configuration-migration-in-cicd: Configuration migration in CI/CD
  upgrading-the-docker-image: Upgrading the Docker image
  removing-the-docker-image: Removing the Docker image
  next-steps: Next steps
---

# Run as a Docker container

Ping CLI is available as a Docker image, allowing you to run it in containerized environments without installing it directly on your system.

## Before you begin

You must have:

* Docker installed and running on your system.

* Basic familiarity with Docker commands.

You can find installation instructions in the [Docker documentation](https://docs.docker.com/get-docker/).

## Pull the Ping CLI Docker image

Pull the latest Ping CLI image from Docker Hub:

```console
docker pull pingidentity/pingcli:latest
```

To pull a specific version:

```console
docker pull pingidentity/pingcli:1.0.0
```

## Verify the installation

Verify that the Docker image was pulled successfully:

```console
docker run pingidentity/pingcli:latest --version
```

You should see output similar to:

```console
pingcli version 1.0.0
```

## Running Ping CLI in Docker

### Basic usage

Run Ping CLI commands inside the container:

```console
docker run pingidentity/pingcli:latest --help
```

### Interactive shell

To run Ping CLI interactively inside the container:

```console
docker run -it pingidentity/pingcli:latest
```

### Mounting local directories

To work with configuration files stored on your host system, mount a local directory:

```console
docker run -v /path/to/local/config:/app/config pingidentity/pingcli:latest config list
```

## Using Ping CLI in CI/CD pipelines

Docker makes it easy to use Ping CLI in continuous integration and continuous delivery (CI/CD) workflows. Use the image in GitHub Actions, Docker Compose, or other orchestration tools.

### Configuration migration in CI/CD

When you upgrade the Ping CLI Docker image and use it for the first time, the tool automatically detects the old configuration format and creates a migration plan. For non-interactive environments, set the following environment variable to auto-approve migration:

```console
docker run -e PINGCLI_CONFIG_MIGRATION_POLICY=yes \
  -v /path/to/local/config:/app/config \
  pingidentity/pingcli:latest pingone groups list
```

## Upgrading the Docker image

To upgrade to a newer version of the Ping CLI Docker image:

```console
docker pull pingidentity/pingcli:latest
```

Or pull a specific version:

```console
docker pull pingidentity/pingcli:1.0.0
```

When you run the new image, your configuration files are automatically migrated to the new format on first use. The process is safe and includes automatic backups (stored within the container or mounted volume).

## Removing the Docker image

To remove the Ping CLI Docker image from your system:

```console
docker rmi pingidentity/pingcli:latest
```

Or remove a specific version:

```console
docker rmi pingidentity/pingcli:1.0.0
```

To remove unused images (including dangling ones):

```console
docker image prune
```

## Next steps

Now that you're familiar with running Ping CLI in Docker, 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