---
title: Installing PingID SSH binary package
description: "Binary packages for PingID for Secure Shell (SSH) are available for the following Linux distributions: Ubuntu, Debian, CentOS, RHEL, and SUSE."
component: pingid
page_id: pingid:pingid_integrations:pid_installing_pid_ssh_binary_package
canonical_url: http://docs.pingidentity.com/pingid/pingid_integrations/pid_installing_pid_ssh_binary_package.html
revdate: July 30, 2024
section_ids:
  about-this-task: About this task
  steps: Steps
  choose-from: Choose from:
  choose-from-2: Choose from:
  choose-from-3: Choose from:
  result: Result:
---

# Installing PingID SSH binary package

Binary packages for PingID for Secure Shell (SSH) *(tooltip: \<div class="paragraph">
\<p>Protocol for secure operation of network services over an unsecured network.\</p>
\</div>)* are available for the following Linux distributions: Ubuntu, Debian, CentOS, RHEL, and SUSE.

## About this task

The binary packages for PingID for SSH are supported on the following Linux versions:

* Ubuntu 14.x to 22.x

* Debian 9.x to 12.x

* CentOS 7.x and later

* Red Hat Enterprise Linux (RHEL) 7.x and later

* OpenSUSE Leap 42.3, 15.x, and SUSE Linux Enterprise (SLES) 11.0 to 15.x

|   |                                                                                                                                                                                                                                                                                |
| - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|   | Adding multi-factor authentication (MFA) to a Unix or Linux system might result in locking you out of the system. To minimize this risk, back up your system before beginning an installation, and during an installation, keep a separate open session with root permissions. |

## Steps

1. Get the public key used to sign the package.

   ### Choose from:

   * On Ubuntu 22.x and Debian 12.x:

     ```shell
     curl -s https://packages.pingidentity.com/pub-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/pingid.gpg
     ```

   * On earlier versions of Ubuntu and Debian:

     ```shell
     curl -s https://packages.pingidentity.com/pub-key.gpg | sudo apt-key add -
     ```

   * On CentOS, RHEL, and SUSE:

     ```
     sudo rpm --import https://packages.pingidentity.com/pub-key.gpg
     ```

2. Update the repository information.

   ### Choose from:

   * On Ubuntu:

     1. Add the PingID repository to the list of sources:

        ```
        echo "deb \http://packages.pingidentity.com/repo <release code name> <release code name>" | sudo tee /etc/apt/sources.list.d/pingid.list
        ```

        For example, on Ubuntu 20.04:

        ```
        echo "deb \http://packages.pingidentity.com/repo focal focal" | sudo tee /etc/apt/sources.list.d/pingid.list
        ```

     2. Update the package information from the list of sources:

        ```
        sudo apt update
        ```

   * On Debian:

     1. Add the PingID repository to the list of sources:

        ```
        echo "deb http://packages.pingidentity.com/repo <release code name> <release code name>" | sudo tee /etc/apt/sources.list.d/pingid.list
        ```

        For example, on Debian 10.x (Buster):

        ```
        echo "deb http://packages.pingidentity.com/repo buster buster" | sudo tee /etc/apt/sources.list.d/pingid.list
        ```

     2. Update the package information from the list of sources:

        ```
        sudo apt update
        ```

        |   |                                                                                                                               |
        | - | ----------------------------------------------------------------------------------------------------------------------------- |
        |   | If you are not sure what Debian release you have, run the following command to check:```
        grep PRETTY_NAME /etc/os-release
        ``` |

   * On CentOS:

     Copy file http\://packages.pingidentity.com/repo/CentOS/pingidentity.repo\[] to `/etc/yum.repos.d/pingidentity.repo` using the following command:

     ```
     sudo curl -o /etc/yum.repos.d/pingidentity.repo \http://packages.pingidentity.com/repo/CentOS/pingidentity.repo
     ```

   * On RHEL:

     Copy file http\://packages.pingidentity.com/repo/RHEL/pingidentity.repo\[] to `/etc/yum.repos.d/pingidentity.repo` using the following command:

     ```
     sudo curl -o /etc/yum.repos.d/pingidentity.repo \http://packages.pingidentity.com/repo/RHEL/pingidentity.repo
     ```

   * On SUSE:

     1. Add the PingID repository using the following command:

        ```
        sudo zypper ar \http://packages.pingidentity.com/repo/SUSE/pingidentity.repo
        ```

     2. Refresh the repository:

        ```
        sudo zypper ref pingidentity
        ```

3. Install the PingID package.

   ### Choose from:

   * On Ubuntu and Debian:

     ```
     sudo apt install pingid
     ```

   * On CentOS and RHEL:

     ```
     sudo yum install pingid
     ```

   * On SUSE:

     ```
     sudo zypper in pingid
     ```

4. Download the properties file. See [Integrate PingID with SSH](pid_integration_with_ssh_intro.html).

5. Copy the properties file to `/etc/pingid/pingid.properties`.

6. Test the installation:

   ```
   pingid_fc -v
   ```

   ### Result:

   You should see a message similar to the following:

   ```
   PingID API version 4.0 (Package version 4.0.12)
   						Configuration file: /etc/pingid/pingid.conf
   ```