--- title: Installing the PingID desktop app (legacy) description: This section documents the legacy PingID desktop app. component: pingid page_id: pingid:pingid_service_management:installing_pid_desktop_app canonical_url: http://docs.pingidentity.com/pingid/pingid_service_management/installing_pid_desktop_app.html revdate: April 13, 2026 section_ids: installing-the-desktop-app-legacy-using-the-windows-cli: Installing the desktop app (legacy) using the Windows CLI about-this-task: About this task steps: Steps examplecusersadmindownloadspingid-1-5-0-exe-verysilent-suppressmsgboxes-sp-logcusersadmintemplogspingiddesktopapplog-log: "Example:C:\\Users\\Admin\\Downloads\\PingID-1.5.0.exe /VERYSILENT /SUPPRESSMSGBOXES /SP- /LOG=\"C:\\Users\\Admin\\Temp\\Logs\\PingIDDesktopAppLog.log\"" installing-the-desktop-app-legacy-using-the-mac-cli: Installing the desktop app (legacy) using the Mac CLI about-this-task-2: About this task steps-2: Steps example-codephsudo-installer-pkg-homedownloadspingid-pkg-target-applications: Example:[.codeph]``sudo installer -pkg $HOME/Downloads/PingID.pkg -target /Applications / result: Result --- # Installing the PingID desktop app (legacy) | | | | - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | This section documents the legacy PingID desktop app.Learn how to configure the most up-to-date version for a consistent PingID desktop app passwordless experience in [PingID desktop app](http://docs.pingidentity.com/pingone/strong_authentication_mfa/p1_pid_desktop_app_start.html) in the PingOne documentation. | Install the PingID desktop app (legacy) as an administrator, using the command-line interface (CLI) or the UI wizard. * To install on Windows: * To use the UI wizard, refer to [Setting up PingID desktop authentication on Windows](http://docs.pingidentity.com/pingid-user-guide/secure_authentication_with_pingid/ug_pid_desktop_app_web.html) in the PingID User Guide. * To use the CLI, refer to [Installing the desktop app (legacy) using the Windows CLI](installing_pid_desktop_app_using_windows_cli.html). * To install on Mac: * To use the UI wizard, refer to [Setting up PingID desktop app (legacy) on a Mac](http://docs.pingidentity.com/pingid-user-guide/secure_authentication_with_pingid/ug_pid_desktop_app_web.html) in the PingID User Guide. * To use the CLI, refer to [Installing the desktop app (legacy) using the Mac CLI](installing_pid_desktop_app_using_mac_cli.html). ## Installing the desktop app (legacy) using the Windows CLI Install the PingID desktop app (legacy) using the command-line interface (CLI). This is useful for deploying on multiple machines in batch mode. ### About this task | | | | - | ------------------------------------------------------------------------------- | | | Running the installer from the command line requires administrator permissions. | ### Steps 1. Download the PingID desktop app (legacy) installer from the [PingID desktop download page](https://downloads.pingidentity.com/pingid/pc-client/PingID.exe). 2. Open a Command Prompt window with administrator permissions. 3. Create a `.bat` or `.cmd` file containing the following commands for the PingID desktop app (legacy), or run the installer directly from the command line, to supply the parameter values. `\PingID-.exe [/SILENT][/VERYSILENT] [/TASKS="roaminguserprofiles"] [/SUPPRESSMSGBOXES] [/SP-] ][/DIR]` The following table describes each parameter value. | Parameter | Description | | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `/SILENT` or `/VERYSILENT` | The background window and installation progress window are displayed by default. To hide them, include one of the following parameters.- `/SILENT` Hides the background window and shows the installation process window. - `/VERYSILENT` Hides the background window and the installation process window. | | `/TASKS=``"roaminguserprofiles"` | To add support for roaming user profiles, append this parameter. Available for version 1.5.3 and later. There are several conditions to its use.When the parameter is not used in a fresh installation:- When using the `/SILENT` or `/VERYSILENT` parameters, the UI is not shown and the roaming profile setting is unavailable. - Otherwise, the roaming profile setting is shown in the UI unchecked, and can be changed by the user.When the parameter is used in a fresh installation:- In SILENT or VERYSILENT mode, the UI is not shown and roaming profile is used. - Otherwise, the roaming profile setting is shown in the UI as checked, and can be changed by the user.For an upgrade from a previous version or reinstall of the same version:- This CLI setting is ignored. - In SILENT or VERYSILENT mode, the UI is not shown. The previous installation setup is maintained. - Otherwise, the UI will be shown but the roaming profile check box will be not be shown. | | `/SP-` | Disables the prompt `"This will install…​ Do you wish to continue?"` that appears by default when the installation starts. | | `/SUPPRESSMSGBOXES` | Instructs the installer to suppress message boxes. It only has an effect when combined with `/SILENT` or `/VERYSILENT`. The default response in situations where there's a choice is:- `Yes` in `Keep newer file?` situations. - `No` in `File exists, confirm overwrite` situations. - `Abort` in \`Abort/Retry` situations. - `Cancel` in `Retry/Cancel` situations. - `Yes` (continue) in `DiskSpaceWarning, DirExists, DirDoesntExist, NoUninstallWarning, ExitSetupMessage,`and `ConfirmUninstall` situations. - `Yes` (restart) in `FinishedRestartMessage` and`UninstalledAndNeedsRestart` situations. | | `/LOG=`` `` ` | * `/LOG`< without an assigned value will create a log file in the user's TEMP directory, detailing file installation and actions taken during the installation process. * /`LOG=` allows you to specify a fixed path or filename to use for the log file. If a file with the specified name already exists, it will be overwritten. If the file cannot be created, the installer will abort with an error message. | | `/DIR=`\ | Defines the path to which you want to install the app. A fully qualified pathname must be specified in the format` x:\directorypath`. If no path is defined, the default path is used. | #### Example:`C:\Users\Admin\Downloads\PingID-1.5.0.exe /VERYSILENT /SUPPRESSMSGBOXES /SP- /LOG="C:\Users\Admin\Temp\Logs\PingIDDesktopAppLog.log"` This example instructs the installer to install the PingID desktop app (legacy), with the following settings: * Runs the installer executable, located in the Downloads folder. * Does not display the background window and installation progress window (`/VERYSILENT` parameter). * Does not display message boxes and prompts (`/SUPPRESSMSGBOXES` and `/SP-` parameters). * Sends the log output to a customized destination (`/LOG` parameter). 4. To verify the installation, test that a user can open the PingID desktop app (legacy) instance on their Windows machine and pair their device. For more information, see [Setting up PingID desktop authentication on Windows](http://docs.pingidentity.com/pingid-user-guide/secure_authentication_with_pingid/ug_pid_desktop_app_web.html). ## Installing the desktop app (legacy) using the Mac CLI Install the PingID desktop app (legacy) using the command-line interface (CLI). This is useful for deploying on multiple machines in batch mode. ### About this task | | | | - | -------------------------------------------------------------------------------- | | | Running the installer from a Terminal window requires administrator permissions. | ### Steps 1. Download the installer for the PingID desktop app (legacy) from the [PingID desktop download page](https://downloads.pingidentity.com/pingid/mac-client/PingID.pkg). 2. Open a Terminal window and enter the following command. `sudo installer -pkg -target /` * *\* is the downloaded installer package's full filepath. * *\* is the full filepath location that will host the PingID desktop app (legacy) installation with its initial configuration. #### Example:\[.codeph]\`\`sudo installer -pkg $HOME/Downloads/PingID.pkg -target /Applications / ``` `` ``` This command uses the PingID desktop app (legacy) installer package downloaded to the default Downloads directory and installs it in the Applications directory. 3. When prompted, enter the administrator password. ### Result The PingID desktop app (legacy) is silently installed, using the application defaults. A message displays indicating the installation is successful.