# Adding GitHub Enterprise organization to GitProtect

**Integrating a GitHub Enterprise organization with GitProtect allows centralized backup and management of all repositories within the selected GitHub environment. Once the organization is connected, administrators can set backup schedules, apply retention policies, organize repositories into groups, and monitor synchronization status and backup times directly from the dashboard to ensure consistent protection and compliance with data security policies.**

***

## Important notice

Integration with **GitHub Enterprise Cloud** and **GitHub Enterprise Server** in **GitProtect** is only possible through a personal access token (PAT).

Additionally, if a **GitHub Enterprise Cloud** organization with data residency includes managed users with SSO enabled, **the token must be authorized**. Although authorizing the token in a single organization allows **GitProtect** to retrieve all organizations, we recommend authorizing each one you intend to protect. Token authorization is also required in any organization to which you plan to restore data.

{% hint style="info" %}
You can find more information about token authorization in the [Useful links and items](#useful-links-and-items) section.
{% endhint %}

***

## Integration process

The below steps demonstrate how to quickly integrate a **GitHub Enterprise** organization with **GitProtect** using **GitProtect Management Service**.

{% hint style="success" %}
**GitProtect** supports backup and restore for **GitHub Enterprise Cloud** deployments that are separated from the main **GitHub** environment (for example, <kbd>your-org.ghe.com</kbd>). You can integrate isolated **GitHub Enterprise Cloud** instances as **GitHub Enterprise Cloud with Data Residency**.
{% endhint %}

{% stepper %}
{% step %}
Open the **DevOps** tab on the left side of the window and select **GitHub** from the list.

<figure><img src="/files/cvAXuFBmnNrNQFX3HjX7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Connect** under the appropriate **GitHub Enterprise** instance type (**GitHub Enterprise Server** or **GitHub Enterprise Cloud with Data Residency**).

{% hint style="info" %}
If you already have a **GitHub Enterprise** organization added, click the **+ Add new** button in the top-left corner first.
{% endhint %}

<figure><img src="/files/1um4F4BYXtgi8EqjmcSS" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
In **Settings**, enter the **GitHub Enterprise** service address and add or select a personal access token (PAT) from the **Password Manager**.

<figure><img src="/files/TBrCVDsyHAO7jrYbgI3M" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Choose whether **GitProtect** should automatically add new repositories to your backup.

<figure><img src="/files/hT8i6pQ6r1dkA2ROR9yZ" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Configure the repository synchronization and the default worker. Specify the synchronization start time or set a time interval for automatic updates.

<figure><img src="/files/RtmdbxlhcRKzgxVZiuMR" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Proceed** to complete the process of adding your **GitHub Enterprise** organization and grant **GitProtect** access to the specified resources.
{% endstep %}

{% step %}
Your **GitHub Enterprise** organization has been successfully added to **GitProtect**. Click **Custom policy** to modify the backup policy settings, or click **Run backup** to start the backup immediately using the current policy configuration.

<figure><img src="/files/p6wPDSAu1089U9EpGUPJ" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Useful links and items

{% embed url="<https://docs.github.com/en/enterprise-server@3.4/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token>" %}

{% embed url="<https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens>" %}

{% embed url="<https://docs.github.com/en/enterprise-cloud@latest/authentication/authenticating-with-single-sign-on/authorizing-a-personal-access-token-for-use-with-single-sign-on>" %}


---

# 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://helpcenter.gitprotect.io/backup-and-recovery/devops/github-enterprise/integration/adding-github-enterprise-organization-to-gitprotect.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.