Add a GitHub App

When you add a GitHub app, a default repository group is automatically created, and includes the repositories that you specify. You can create more repository groups for data that has different backup requirements.

Procedure

1. From the navigation pane, go to Protect > DevOps.

   The DevOps page appears.

2. In the upper-right area of the page, click Add app.

   The Add DevOps dialog box appears.

3. Click the GitHub tile.

4. Click Next.

   The Select Plan page appears.

5. Select the backup plan to back up the applications.

   If you don't already have a backup plan that you can use, to create one, click the add button.

6. Click Next.

   The Configure App page appears.

7. Complete the following steps:

   1. In App name, type a name for the app.

   2. To back up an on-premises GitHub enterprise server, in the Host URL box, enter the URL for the GitHub enterprise server.

   3. In Token name, type the name of the token to access the app.

   4. In the Access token box, enter the access token to access the app.

      For more information about creating an access token, go to the GitHub docs site.

      For information about the required access token permissions and user roles, see Personal Access Token Permissions and User Roles.

   5. Click Next.

      The Access Nodes page appears.

8. Complete the following steps:

   1. In Access node type, specify the OS of the access node for GitHub.

   2. From the Access nodes list, select the access nodes to use for the backup operation.

   3. In Staging path, enter the path where you want to stage the projects and repositories.

      By default, the Job Results directory is used as the staging path. You can specify a different staging path. The staging path can be either a local path or a UNC path. You cannot specify a mounted path under a drive as the staging path.

   4. To browse the app with credentials, move the Impersonate User toggle key to the right, and then type the credentials needed to access the app.

      If you provide a UNC path for staging, you must impersonate a user that has access permissions to the UNC path.

   5. Click Next.

      The Backup Content page appears.

9. Complete the following steps:

   1. From the Account type list, select the account type—personal or business/institution—and then select the account or organization.

      To back up the repositories owned by the user account, select Personal. To back up the repositories owned by the organization, select Business/Institution.

   2. In Organization name, select the organization.

   3. Click Submit.