# Installation

## Time and Prerequisites

Total Time expected: 2-3 minutes

Access required: Admin permissions on Slack and Admin Permissions on PagerDuty

This page will guide you through how to install PagerSync on your slack instance and then connect to your PagerDuty account.

## Install on Slack

First install the app on slack by navigating to the link: <https://app.pagersync.com/slack/install>

<figure><img src="https://651642112-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FceJdDZ6Dms9cqRzjUCiT%2Fuploads%2FnqOYLCFLeDqCivzj5s5M%2Fimage.png?alt=media&#x26;token=c6aa8bdb-0bad-4a7a-acdb-182ce10ccdf6" alt=""><figcaption><p>App Installation Button Page</p></figcaption></figure>

This will prompt a page like this:

<figure><img src="https://651642112-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FceJdDZ6Dms9cqRzjUCiT%2Fuploads%2FHG4dGvyXqLGw94sTvGaS%2Fimage.png?alt=media&#x26;token=36159480-9f0d-44b5-93b9-ef5b485e1967" alt=""><figcaption><p>App instalation page that shows the permissions required for PagerSync</p></figcaption></figure>

Once the app is successfully installed, it will prompt you to open the app in Slack

<figure><img src="https://651642112-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FceJdDZ6Dms9cqRzjUCiT%2Fuploads%2Fks42rnj2aSwHFxNBagBQ%2Fimage.png?alt=media&#x26;token=af757630-a5dc-4e65-b264-302a478d4731" alt=""><figcaption><p>App installation succeeded </p></figcaption></figure>

Once the app is installed it should show you the home screen of the app.

<figure><img src="https://651642112-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FceJdDZ6Dms9cqRzjUCiT%2Fuploads%2FV9rxbnOZ5pWIgKEcmd8R%2Fimage.png?alt=media&#x26;token=82fea5aa-35ca-46a3-98e5-d1b67d231afb" alt=""><figcaption><p>App home page after installation</p></figcaption></figure>

{% hint style="info" %}
At this point PagerSync is installed on your slack instance
{% endhint %}

## Install PagerDuty

PagerSync relies on OAuth integration with PagerDuty. PagerSync only requires read only access to PagerDuty.

Click on the link within the app home page to link to PagerDuty. PagerDuty will take you through an OAuth flow to install the app on your instance. Ensure you grant access. If the flow goes through smoothly, you will get a page that PagerDuty was installed successfully.&#x20;

At this point go back to the home screen of the app. Navigate to another page and come back to the PagerSync App Home. If you still see the old screen which does not show that the PagerDuty link is updated, then refresh the slack by using the `command + r` for Mac or `control + r` on windows.

Your home page should look like this.

<figure><img src="https://651642112-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FceJdDZ6Dms9cqRzjUCiT%2Fuploads%2F6iyUNZvM7GtGGmb8GvAw%2Fimage.png?alt=media&#x26;token=d5e52c63-b571-4042-a54f-1531d8584fac" alt=""><figcaption></figcaption></figure>

## Ops Genie Integration

PagerSync also supports OpsGenie now.

You can integrate it through API key.

Step 1: Create a key in Ops Genie with read and configuration access.

<figure><img src="https://651642112-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FceJdDZ6Dms9cqRzjUCiT%2Fuploads%2Fg7ZBaAlFPvpY3XGw8PXN%2Fcreate%20opsgenie%20key.png?alt=media&#x26;token=9a75979c-958a-469b-b9c6-b2432caefee4" alt=""><figcaption><p>Create API Key in Ops Genie</p></figcaption></figure>

Step 2: Store this key into PagerSync

<figure><img src="https://651642112-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FceJdDZ6Dms9cqRzjUCiT%2Fuploads%2Fca8hsYfkIfjImBdtP5MM%2FChoose%20Add%20API%20Key.png?alt=media&#x26;token=08f07511-02de-451d-a25a-0d2beaad6b88" alt=""><figcaption></figcaption></figure>

<figure><img src="https://651642112-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FceJdDZ6Dms9cqRzjUCiT%2Fuploads%2F9Wg2Yjb0EHdxEpq7GRCe%2Fadd%20key.png?alt=media&#x26;token=fccc709e-1190-480c-8f91-8e13162c639f" alt=""><figcaption><p>Paste the key from Ops Genie into PagerSync and hit Submit</p></figcaption></figure>
