# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pagersync.com/getting-started/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
