fcb5246fd7
Co-authored-by: Isaac Brown <101839405+isaacmbrown@users.noreply.github.com> Co-authored-by: isaacmbrown <isaacmbrown@github.com>
3.0 KiB
title, intro, redirect_from, versions, topics, shortTitle
| title | intro | redirect_from | versions | topics | shortTitle | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Installing your own GitHub App | You can install a {% data variables.product.prodname_github_app %} that you created on the account that owns the app. If your app is public, the {% data variables.product.prodname_github_app %} can also be installed on other accounts. |
|
|
|
Install your own app |
About installing your own {% data variables.product.prodname_github_app %}
After creating a {% data variables.product.prodname_github_app %}, you can install it based on its visibility.
- Only on this account: The {% data variables.product.prodname_github_app %} can only be installed on the account that created it.{% ifversion enterprise-apps-public-beta %} This visibility is not available for apps{% ifversion ghec %} created by a {% data variables.enterprise.prodname_managed_user %} or{% endif %} registered by an enterprise.{% endif %}
- Any account: You can install this {% data variables.product.prodname_github_app %} on any account you control.{% ifversion enterprise-apps-public-beta %} This visibility is not available for apps registered by an enterprise.
- Only enterprise organizations: If the {% data variables.product.prodname_github_app %} is owned by an enterprise, you can only install the app on{% ifversion enterprise-installed-apps %} that enterprise or{% endif %} organizations within the enterprise. Organizations where you are an organization owner will appear in the installation options.{% endif %}{% ifversion ghec %}
If you are an {% data variables.product.prodname_emu %}, you cannot install a {% data variables.product.prodname_github_app %} on your user account.{% endif %}
Installing your own {% data variables.product.prodname_github_app %}
{% data reusables.apps.settings-step-personal-orgs %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %}
-
Next to the {% data variables.product.prodname_github_app %} that you want to install, click Edit.
-
Click Install App.
-
Click Install next to the location where you want to install the {% data variables.product.prodname_github_app %}.
-
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 {% data variables.product.company_short %}.
If the app does not require repository permissions, these options will be omitted.
-
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.
-
Click Install.