Installing a GitHub App from GitHub Marketplace for your organizations

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 organization account and you choose a paid plan, you will pay for your app subscription on your organization's current billing date using your organization's existing payment method.

如果您选择免费试用付费计划，可在试用期内随时取消，无需付费，但取消后将自动失去对应用程序的访问权限。 您付费的订阅将在 14 天试用结束时开始。 有关详细信息，请参阅“关于 GitHub Marketplace 的计费”。

For more information about installing an OAuth App from GitHub Marketplace, see "在组织中安装 OAuth 应用."

About installing GitHub Apps

In order to use a GitHub App on your repositories or organization, you must install the app.

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 "GitHub 应用程序所需的权限."

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 "GitHub 应用程序所需的权限."

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.

在帐户或组织上安装 GitHub App 时，即表示向应用授予访问其请求的组织和存储库资源的权限。 还需要指定应用可以访问的存储库。

授权 GitHub App 时，即表示根据应用请求的帐户权限授予应用访问 GitHub 帐户的权限。 还需要授予应用代表你执行操作的权限。

无需授权应用即可安装 GitHub App。 同样，无需安装应用即可授权应用。

For more information about authorizing GitHub Apps, see "授权 GitHub Apps."

Requirements to install a GitHub App on an organization

Organization owners can install GitHub Apps on their organization.

Admins of repositories that are owned by an organization can also install GitHub 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 resources. Organization owners can prevent outside collaborators who are repository admins from installing GitHub Apps.

The "app manager" role in an organization does not give a person the ability to install a GitHub App in the organization. For more information, see "About GitHub App managers."

Installing a GitHub App in your organization

1. 在导航栏的任意页面顶部，单击“市场”。

   

2. 浏览到要安装的应用程序，然后单击该应用程序的名称。

3. 在应用页上的“定价和设置”下，单击你想要使用的定价计划。

4. 单击“免费安装”、“向 GitHub 购买”或“免费试用 14 天” 。

5. 为应用选择安装组织。 此过程将略有不同，具体取决于组织的服务条款。

   • 如果你已获得 GitHub 权限来收集组织的名称和地址信息，请在“账单信息”部分中，选择“切换计费帐户” 下拉菜单，然后单击要在其中安装该应用的组织。

   

   • 否则，请在“查看订单”下，选择“帐户”下拉菜单，然后单击要安装该应用的组织。

   

6. 如果已选择付款计划，请检查您的付款方式。

   • 要更改组织已存档的现有付款方式，请单击“编辑”，然后填写表单以添加新的付款方式。
   • 如果组织没有已存档的付款方式，请单击“添加付款方式”，然后填写表单以添加信用卡或 PayPal 帐户。

7. 单击“完成订单并开始安装”。

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. 如果您选择向有限的仓库而非您所有仓库授予应用程序访问权限，请输入您要授予应用程序访问权限的每个仓库的名称，然后单击仓库名称以选择它。

10. 查看应用的访问权限，然后单击“安装”。

Further reading

• "添加或编辑付款方式"
• "Installing a GitHub App from GitHub Marketplace for your personal account"