About installing Apps
This article describes how to install a App directly from the app owner instead of from Marketplace. For more information on installing Apps from Marketplace, see Installing a App from Marketplace for your personal account and Installing a App from Marketplace for your organizations. For more information about installing Apps that you own, see Installing your own App.
In order to use a App on your repositories or organization, you must install the app on your organization or personal account. You can install the same App on multiple accounts. For example, if you install the app on your personal account and on a few organizations that you own, you'll be able to use the app on your personal repositories, on the organizations where you installed the app, and on repositories owned by those organizations.
When you install an app, you grant the app permission to access the organization and repository resources that it requested. During the installation process, will tell you which permissions the App requested. For more information about the REST API requests the App can make with those permissions, see Permissions required for Apps.
When you install an app, you will also choose which repositories to grant the App access to.
Before installing a App, you should ensure you trust the owner of the App. You should also review the permissions that the App is requesting and make sure you are comfortable granting those permissions. For more information about the REST API requests the App can make with those permissions, see Permissions required for Apps.
There is no limit to how many apps you can install.
Difference between installation and authorization
After you install a App, you may also be asked to authorize the app.
When you install a App on your account or organization, you grant the app permission to access the organization and repository resources that it requested. You also specify which repositories the app can access. During the installation process, the App will indicate which repository and organization permissions you are granting. For more information about what different permissions enable a App to do, see Choosing permissions for a App.
For example, you might grant the App permission to read repository metadata and write issues, and you might grant the App access to all of your repositories.
When you authorize a App, you grant the app access to your account, based on the account permissions the app requested. During the authorization process, the app will indicate which resources the app can access on your account. When you authorize a App, you also grant the app permission to act on your behalf.
For example, you might grant the App permission to read your email addresses and write gists.
You can install a App without authorizing the app. Similarly, you can authorize the app without installing the app.
For more information about authorizing Apps, see Authorizing Apps.
Requirements to install a App
Anyone can install Apps on their personal account.
Organization owners can install Apps on their organization.
Admins of repositories that are owned by an organization can also install Apps on the organization if they only grant the app access to repositories that they are an admin of and if the app does not request any organization permissions or the "repository administration" permission. Organization owners can prevent outside collaborators who are repository admins from installing Apps.
Organization members who are not organization owners or repository admins can still select the organization during the install process. Instead of installing the app, will send a notification to the organization owner to request the organization owner to install the app.
The "app manager" role in an organization does not give a person the ability to install a App in the organization. See About App managers.
Installing a App
During the installation process, the app owner will direct you to a URL to install the App. The URL will look something like https://.com/apps/APP-NAME/installations/new, where APP-NAME is the name of the App.
Select the location where you want to install the App. You can select your personal account or an organization that you are a member of.
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 .
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.
Review the permissions that the app is requesting. For more information about the REST API requests the App can make with those permissions, see Permissions required for Apps.
Click Install, Install and request, or Request. The button that is presented depends on whether your organization owner must approve none, some, or all of the requested access for the app. For more information, see Requirements to install a App.