Installing a GitHub App from GitHub Marketplace for your personal account

About GitHub Marketplace

This article applies to installing and purchasing GitHub Apps from GitHub Marketplace. For more information on installing GitHub Apps from a source other than GitHub Marketplace, see "Installing a GitHub App from a third party."

If you install a GitHub App on your personal account and you choose a paid plan, you will pay for your app subscription on your personal account's current billing date using your existing payment method.

If you choose a paid plan with a free trial, you can cancel at any time during your trial period without being charged, but you will automatically lose access to the app. Your paid subscription will start at the end of the 14-day trial. For more information, see "About billing for GitHub Marketplace."

For more information about installing an OAuth app instead of a GitHub App from GitHub Marketplace, see "Installing an OAuth app in your personal account."

About installing GitHub Apps

In order to use a GitHub App on your repositories or organization, you must install the app on your organization or personal account. You can install the same GitHub 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, GitHub will tell you which permissions the GitHub App requested. For more information about the REST API requests the GitHub App can make with those permissions, see "Permissions required for GitHub Apps."

When you install an app, you will also choose which repositories to grant the GitHub App access to.

Before installing a GitHub App, you should ensure you trust the owner of the GitHub App. You should also review the permissions that the GitHub App is requesting and make sure you are comfortable granting those permissions. For more information about the REST API requests the GitHub App can make with those permissions, see "Permissions required for GitHub Apps."

There is no limit to how many apps you can install.

Difference between installation and authorization

After you install a GitHub App, you may also be asked to authorize the app.

When you install a GitHub 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 GitHub App will indicate which repository and organization permissions you are granting. For more information about what different permissions enable a GitHub App to do, see "Choosing permissions for a GitHub App."

For example, you might grant the GitHub App permission to read repository metadata and write issues, and you might grant the GitHub App access to all of your repositories.

When you authorize a GitHub App, you grant the app access to your GitHub 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 GitHub App, you also grant the app permission to act on your behalf.

For example, you might grant the GitHub App permission to read your email addresses and write gists.

You can install a GitHub App without authorizing the app. Similarly, you can authorize the app without installing the app.

For more information about authorizing GitHub Apps, see "Authorizing GitHub Apps."

Installing a GitHub App in your personal account

1. To open GitHub Marketplace, in the top-left corner of GitHub, select , then click Marketplace.

   

2. Browse to the app you'd like to install, then click on the app's name.

3. On the app's page, under "Pricing and setup," click the pricing plan you'd like to use.

4. Click Install it for free, Buy with GitHub, or Try free for 14 days.

5. Under "Review your order," in the Account dropdown menu, confirm that you're installing the app for your personal account.

6. If you chose a paid plan, in the "Payment Method" section, review your payment method.

   • To change the existing payment method on file for your personal account, click Edit, then complete the form to add a new payment method.
   • If there isn't a payment method on file for your personal account, complete the form to add a credit card or PayPal account.

7. Click Complete order and begin installation.

8. If the app requires access to repositories, select All repositories or Only select repositories.

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

9. If you chose to give the app access to limited repositories instead of all of your repositories, type the name of each repository you'd like to give the app access to, then click on the repository name to select it.

10. Review the app's access permissions, then click Install.

Further reading

• "Adding or editing a payment method"
• "Installing a GitHub App from GitHub Marketplace for your organizations"