---
title: Installing the first PingDirectoryProxy server
description: Install the first PingDirectoryProxy server from the .zip installation file.
component: pingdirectory
version: 11.0
page_id: pingdirectory:pingdirectoryproxy_server_administration_guide:pd_proxy_install_first_dps
canonical_url: https://docs.pingidentity.com/pingdirectory/11.0/pingdirectoryproxy_server_administration_guide/pd_proxy_install_first_dps.html
revdate: September 13, 2023
section_ids:
  about-this-task: About this task
  steps: Steps
  example: Example:
  example-2: Example:
  example-3: Example:
  result: Result:
  next-steps: Next steps
---

# Installing the first PingDirectoryProxy server

Install the first PingDirectoryProxy server from the `.zip` installation file.

## About this task

To begin with, we have the PingDirectoryProxy installation `.zip` file. In this example, we plan to use SSL security, so we also have a key store certificate database and a `.pin` file that contains the private key password for the key store. The key store files are only necessary when using SSL or StartTLS.

In this deployment scenario, the key store database is assumed to be a Java KeyStore (JKS), which can be created by the keytool program.

The PingDirectoryProxy directory contains the following.

```
root@proxy-east-01: ls
ExampleKeystore.jks   ExampleTruststore.jks ExampleKeystore.pin
PingDirectoryProxy-8.0.0.0-with-je.zip
```

The `ExampleKeystore.jks` key store file contains the private key entry for the `proxy-east-01.example.com` server certificate with the alias `server-cert`. The server certificate, certificate authority (CA), and intermediate signing certificates are all contained in the `ExampleTruststore.jks` file. The password for `ExampleKeystore.jks` is defined in clear text in the corresponding `.pin` file, though the name of the file need not match as it does in this example. The private key password in this example is the same as the password defined for the `ExampleKeystore.jks` key store.

## Steps

1. Extract the compressed archive file into the PingDirectoryProxy directory and change to this directory.

   ### Example:

   ```
   root@proxy-east-01: unzip -q PingDirectoryProxy-<version>-with-je.zip
   root@proxy-east-01: cd PingDirectoryProxy
   ```

2. Copy the key store and `.pin` files into the `config` directory.

   ### Example:

   ```
   root@proxy-east01: cp ../Keystore config/
   root@proxy-east01: cp ../Truststore config/
   ```

3. Install the first proxy server by running the `setup` tool on `proxy-east-01.example.com`.

   ### Example:

   ```
   root@proxy-east01: ./setup --no-prompt --acceptLicense \
   --ldapPort 389 --rootUserPassword pass \
   --maxHeapSize 1g --enableStartTLS --ldapsPort 636 \
   --useJavaKeystore config/ExampleKeystore.jks \
   --keyStorePasswordFile config/ExampleKeystore.pin \
   --certNickname server-cert \
   --useJavaTrustStore config/ExampleTruststore.jks
   ```

   ### Result:

   New key store password files are created in `config/keystore.pin`. The original file, `config/ExampleKeystore.pin`, is no longer needed. If you are not using SSL or StartTLS, then the SSL arguments are not necessary.

   ```
   root@proxy-east01: ./setup --no-prompt --acceptLicense \
   --ldapPort 389 --rootUserPassword pass --maxHeapSize 1g
   ```

## Next steps

After installing the PingDirectoryProxy server, you can configure it using the `create-initial-proxy-config` tool as presented in [Configuring the first PingDirectory server](pd_proxy_config_first_dps.html).