Installing the GitHub App

You can go to https://github.com/apps/ebert and install our GitHub App on any specific GitHub account or organization. You will also be prompted to select if Ebert should have access to all repositories of the account/organization, or if you want to restrict Ebert’s access to specific repositories.

Installing the GitHub App on github.com

Linking GitHub installations and Ebert accounts

When you install the App on GitHub, Ebert will attempt to link the installation to an Ebert account for you, using the following rules.

  1. If you are using Ebert for the first time, a new account will be created matching the name of the user or organization on which the integration was installed.
  2. If you already owns an account on Ebert with the same name as where the integration was installed, the installation will be associated with your existing Ebert account.
  3. If the installation can’t be associated with any of your existing accounts on Ebert, a new account will be created to hold the installation.

Migrating your installation to an existing Ebert account

If you installed the GitHub App and it was linked to a brand new Ebert account and you wish it was linked to your existing account, you can migrate the installation to another account you own.

  1. From your Dashboard page, click on the Account integrations link below the name of the account that was created with the installation.
  2. On the GitHub App installation panel you will find a link for the installation migration page.
  3. You can choose to which account the installation should be migrated to.

📣 Head’s up about migrating installations

Once the installation is migrated from the temporary account, the account that was created when the integration was installed will be deleted. You can only migrate the installation from accounts that do not have any repositories under review.

After migrating an App installation to an existing account you will have the opportunity to upgrade existing repositories from the OAuth2 token to be reviewed through the App instead.

Upgrading repositories to use your GitHub App installation

After installing the App (and migrating it if necessary), you can now upgrade repositories that are being reviewed through the OAuth2 token workflow to use App instead.

  1. From your Dashboard page, click on the Account integrations link below the name of the account that has the repositories you want to upgrade.
  2. On the GitHub App installation panel you will find a link for the repository upgrade page.
  3. Click on Upgrade repository for each repository you want to upgrade.

Upgrading a repository to be reviewed through the GitHub App

What will change if I upgrade my repositories?

  1. Upgrading a repository to be reviewed through the integration’s installation means that the repo will be reviewed by the ebert[bot] GitHub account instead of the one that owns the OAuth2 token associated with your account.
  2. The installation will have access to only the repositories that you allow it to access through the installation settings, and won’t have access to repositories outside the user/organization where it is installed.

Troubleshooting

The repository I want to migrate is “Not available”

You won’t be able to migrate repositories that are not accessible to the installation, even when they are accessible through the OAuth2 token workflow. You might have to install the integration on multiple GitHub users/organizations and manage them through different Ebert accounts.

Next, review your first repository →

Need more help? Feel free to contact us via email. or chat.