# GitHub

Based on GitHub's specifics, the installation flow for the GitHub App varies according to the permissions of the GitHub account implementing the installation within the target GitHub organization.

## When you can install GitHub Apps on your own

You can initiate the installation from the modal that appears after clicking the "Settings" (Integration) button on GitHub:

![](/docs/_md-assets/12ab27ee5d-start-flow-new.png)

During the process, a separate window will prompt you to choose the installation destination:

![](/docs/_md-assets/0a6966a274-list-organizations.png)

At this step, if an "Install & Authorize" button displays on the confirmation screen after choosing the installation destination, you can independently wrap up the GitHub App installation:

![](/docs/_md-assets/1d1bedc09d-install-and-authorize.png)

Upon completion, a display like the one below should appear on Shisho Cloud. In this case, the installation has been successful.

![](/docs/_md-assets/68f9d56b2e-integrations-github.png)

## When you lack the prerequisite privileges to install GitHub Apps

If the "Authorize & Request" button shows up on the above-mentioned installation destination selection screen, you cannot complete the installation independently. In this situation, please first hit the "Authorize & Request" button:

![](/docs/_md-assets/55a9982606-authorize-and-request.png)

Then, to those with the authority to install the GitHub App, replace the `<installation target organization name>` appropriately, and provide the following information:

> (1) By browsing to `https://github.com/organizations/<installation target organization name>/settings/installations` or visiting "GitHub organization's settings page > Integrations > GitHub Apps", you can confirm the pending GitHub App review request:
>
> ![](/docs/_md-assets/adafbdfde7-pending-requests.png)
>
> (2) Clicking the "Review Request" button displays a screen like this:
>
> (3) Please review the shown details and approve them. Specifically, we'd like you to press the "Approve, Install & Authorize" button.
>
> (4) Upon approval, you should receive a screen like the one below. We kindly ask you to contact us as soon as this screen becomes available:
>
> ![](/docs/_md-assets/e910399d89-callback.png)

After completing the above steps, click the option equivalent to the one in the image below, and carry on with the process using your GitHub account:

![](/docs/_md-assets/b619a41904-start-flow-existing.png)

Subsequently, you should be able to select the organization where you attempted to install the GitHub App earlier. Please select it by clicking:

![](/docs/_md-assets/667dcba3e8-select-existing.png)

This will direct you to the screen below. And with this, your setup is complete.

![](/docs/_md-assets/68f9d56b2e-integrations-github.png)
