Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Installing a GitHub App from GitHub Marketplace for your organizations

You can install GitHub Apps from GitHub Marketplace to use on 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.

Se você escolher um plano pago com um teste gratuito, você pode cancelar a qualquer momento durante o seu período de teste sem ser cobrado, mas você perderá o acesso automaticamente ao aplicativo. A assinatura paga começará a ser contada no fim da versão de avaliação de 14 dias. Para obter mais informações, confira "Sobre a cobrança do GitHub Marketplace".

For more information about installing an OAuth App from GitHub Marketplace, see "Como instalar um aplicativo OAuth na sua organização."

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 "Permissões necessárias para os aplicativos 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 "Permissões necessárias para os aplicativos 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.

Ao instalar um GitHub App em sua conta ou organização, você concede ao aplicativo permissão para acessar os recursos de organização e repositório solicitados. Você também especifica quais repositórios o aplicativo pode acessar.

Ao autorizar um GitHub App, você concede a ele acesso à sua conta do GitHub, com base nas permissões de conta solicitadas. Você também concede permissão ao aplicativo para realizar tarefas em seu nome.

É possível instalar um GitHub App sem autorizar o aplicativo. Da mesma forma, é possível autorizar o aplicativo sem instalá-lo.

For more information about authorizing GitHub Apps, see "Autorizando aplicativos GitHub."

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 "Sobre os gerentes do Aplicativo do GitHub."

Installing a GitHub App in your organization

  1. Na barra de navegação, na parte superior de qualquer página, clique em Marketplace.

    Captura de tela da barra de navegação do GitHub. Um link para GitHub Marketplace está contornado em laranja escuro.

  2. . Navegue até o app que gostaria de instalar e clique no nome do app.

  3. Na página do aplicativo, em "Preços e configuração", clique no plano de preços que você gostaria de usar.

  4. Clique em Instalá-lo gratuitamente, Comprar com o GitHub ou Experimentar gratuitamente por 14 dias.

  5. Escolha uma organização de instalação para o aplicativo. Dependendo dos termos de serviço da organização, esse processo será um pouco diferente.

    • Se você deu permissão a GitHub para coletar informações de nome e endereço para sua organização, na seção "Informações de cobrança", selecione o menu suspenso Alternar conta de cobrança e clique na organização na qual deseja instalar o aplicativo.

    Captura de tela da tela de compra do aplicativo GitHub Marketplace. O menu suspenso azul recolhido rotulado como "Alternar conta de cobrança" está contornado em laranja escuro.

    • Caso contrário, em "Examinar seu pedido", selecione o menu suspenso Conta e clique na organização na qual você deseja instalar o aplicativo.

    Captura de tela da tela de compra do aplicativo GitHub Marketplace. Um menu suspenso cinza recolhido rotulado como "Conta" está contornado em laranja escuro.

  6. Se você escolheu um plano pago, revise o seu método de pagamento.

    • Para alterar a forma de pagamento existente registrada para a organização, clique em Editar e preencha o formulário para adicionar uma nova forma de pagamento.
    • Se não houver uma forma de pagamento registrada para a organização, clique em Adicionar uma Forma de Pagamento e preencha o formulário para adicionar um cartão de crédito ou uma conta do PayPal.
  7. Selecione Concluir pedido e iniciar instalação.

  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. Se você escolheu dar acesso ao aplicativo para repositórios limitados em vez de todos os seus repositórios, digite o nome de cada repositório que você deseja dar acesso ao aplicativo e, em seguida, clique no nome do repositório para selecioná-lo.

  10. Revise as permissões de acesso do aplicativo e clique em Instalar.

Further reading