GitHub App

(2 minute setup time)

Connect the GitHub App

Connecting Emerge's GitHub app will automatically enable Pull Request Comments and GitHub Status Checks.

📘

Note

The Emerge Github app does not require access to source code. It only requests permissions to read metadata and modify pull requests in order to post comments and status checks.

First head over to your Emerge profile and configure a Github connection:

1116

Then choose the appropriate account to install the app under:

1060

Lastly, select the repositories you want Emerge to integrate with:

1066

👍

Congrats on integrating Emerge with GitHub!

Please feel free to contact support with any issues or feedback!

Marketplace install

Alternatively, you can also install the Emerge app directly from the marketplace. After installing, follow the same configuration steps from above.

2020

Github Enterprise Self Hosted

Emerge can also be installed on self hosted GitHub Enterprise by creating a new app for your organization.

  1. Ensure the Emerge IP range is allowed to access your GitHub Enterprise instance.
  2. From your organization settings, open Developer Settings -> GitHub Apps and click New GitHub App
1586
  1. Create a new app with the following fields:
FieldValue
GitHub App nameEmerge Tools
Homepage URLhttps://www.emergetools.com/
Callback URLhttps://www.emergetools.com/success
Setup URLhttps://www.emergetools.com/success
Webhookhttps://api.emergetools.com/githubHook
Checks PermissionsRead & Write
Pull Requests PermissionsRead & Write
  1. After creating the app scroll to the Display information section and upload the Emerge logo. Set the Badge background color to #0F0757
1024
  1. Send the App ID, installation id and private key for signing access token requests to your Emerge representative.
1186
  1. Install the newly created app on the repositories receiving mobile pull requests.
1538