Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.
All products
Apps

This version of GitHub Enterprise was discontinued on 2023-03-15. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Installing your own GitHub App

In this article

You can install a GitHub App that you created on the personal or organization account that owns the app. If your app is public, the GitHub App can also be installed on other accounts.

About installing your own GitHub App

Once you create a GitHub App, you can install it. If your GitHub App is owned by a personal account, you can install it on your account. If your GitHub App is owned by an organization and you are an organization owner, you can install it on the organization.

If your GitHub App is public, you can also share your GitHub App with other users or organizations within your enterprise. For more information, see "Sharing your GitHub App."

Installing your own GitHub App

  1. Navigate to your account settings.

    • For a GitHub App owned by a personal account, in the upper-right corner of any page, click your profile photo, then click Settings.
    • For a GitHub App owned by an organization, in the upper-right corner of any page, click your profile photo, then click Your organizations. Then, to the right of the organization, click Settings.

  2. In the left sidebar, click Developer settings.

  3. In the left sidebar, click GitHub Apps.

  4. Next to the GitHub App that you want to install, click Edit.

  5. Click Install App.

  6. Click Install next to the location where you want to install the GitHub App.

  7. If the app requires repository permissions, select All repositories or Only select repositories. The app will always have at least read-only access to all public repositories on GitHub.

    If the app does not require repository permissions, these options will be omitted.

  8. If you selected Only select repositories in the previous step, under the Select repositories dropdown, select the repositories that you want the app to access.

    If the app creates any repositories, the app will automatically be granted access to those repositories as well.

  9. Click Install.