GitHub

(2 minute setup time)

Connect the GitHub App

First head over to Your Emerge Profile, then click the Connect button in the Integration Settings section.

599599

You can then choose to install the app on either a personal or organizational account that you have access to:

12001200

Then select the repositories you want to have Emerge integrate with:

12601260

👍

Congrats on integrating Emerge with GitHub!

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

Alternative install

You can also install the GitHub app directly on GitHub's website, first login to the GitHub account that has access to the repository you plan to integrate Emerge with. Then head over to our GitHub app page, click Install and then follow the same steps as above.

19881988

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
15861586
  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
10241024
  1. Send the App ID and private key for signing access token requests to your Emerge representative.
11861186
  1. Install the newly created app on the repositories receiving mobile pull requests.
15381538