---
title: Install the provisioner
description: Install and set up the PingFederate GitHub Provisioner.
component: github
page_id: github:github_provisioner:pf_github_connector_installation
canonical_url: https://docs.pingidentity.com/integrations/github/github_provisioner/pf_github_connector_installation.html
revdate: June 25, 2024
section_ids:
  steps: Steps
  example: Example:
---

# Install the provisioner

Install and set up the PingFederate GitHub Provisioner.

## Steps

1. Download the GitHub Provisioner `.zip` archive from the [**Add-ons** tab of the PingFederate downloads page](https://www.pingidentity.com/en/resources/downloads/pingfederate.html) or the [Ping Identity Marketplace](https://marketplace.pingone.com/item/github-single-signon-integration).

   |   |                                                                                 |
   | - | ------------------------------------------------------------------------------- |
   |   | Make sure to select **GitHub Connector 1.0**, not **GitHub EMU Connector 1.0**. |

2. If the PingFederate server is running, stop the server.

3. Extract the GitHub Provisioner distribution `.zip` file.

4. Copy the contents of the `dist` directory into the `<pf_install>/pingfederate/server/default/deploy` directory.

5. (Optional) To use the provisioner for outbound provisioning, in the `<pf_install>/pingfederate/bin/run.properties` file, set the `pf.provisioner.mode` property to `STANDALONE`.

   ### Example:

   ```
   pf.provisioner.mode=STANDALONE
   ```

   |   |                                                                                                                                                                                                                                         |
   | - | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   |   | You can find more information about using the `FAILOVER` setting for runtime deployment in [Deploying provisioning failover](https://docs.pingidentity.com/pingfederate/latest/server_clustering_guide/pf_deploy_provis_failover.html). |

6. Start the PingFederate server.