Skip to main content

Installing an app in your organization

You can install apps from GitHub Marketplace to use in your organization.

Note: This article applies to installing and purchasing apps from GitHub Marketplace only. For more information on apps purchased from integrators, see "About integrations."

Tip: If an app requires organization-level access, then only an organization owner can purchase, install, or cancel the app, and manage app billing for the organization. If the app doesn't require organization-level access, then a repository administrator can install and uninstall the app.

If you choose a paid plan, you'll pay for your app subscription on your organization's current billing date using your organization's 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."

Installing a GitHub App in your organization

  1. In the navigation bar, at the top of any page, click Marketplace.

    Screenshot of the GitHub navigation bar. A link to GitHub Marketplace is outlined in dark orange.

  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. Choose an installation organization for the app. Depending on your organization's terms of service, this process will be slightly different.

    • If you have given GitHub permission to collect name and address information for your organization, in the "Billing information" section, select the Switch billing account dropdown menu, then click the organization in which you'd like to install the app.

    Screenshot of the GitHub Marketplace app purchase screen. A collapsed blue dropdown menu labeled "Switch billing account" is outlined in dark orange.

    • Otherwise, under "Review your order," select the Account dropdown menu, then click the organization in which you'd like to install the app.

    Screenshot of the GitHub Marketplace app purchase screen. A collapsed gray dropdown menu labeled "Account" is outlined in dark orange.

  6. If you chose a paid plan, review your payment method.

    • To change the existing payment method on file for the organization, click Edit, then complete the form to add a new payment method.
    • If there isn't a payment method on file for the organization, click Add a Payment Method, then 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.

  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.

Installing an OAuth App in your organization

If you belong to any organizations that enforce SAML single sign-on, you may be prompted to authenticate through your identity provider before you can authorize an OAuth App. For more information about SAML, see "About authentication with SAML single sign-on" in the GitHub Enterprise Cloud documentation.

  1. In the navigation bar, at the top of any page, click Marketplace.

    Screenshot of the GitHub navigation bar. A link to GitHub Marketplace is outlined in dark orange.

  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. Choose an installation organization for the app. Depending on your organization's terms of service, this process will be slightly different.

    • If you have given GitHub permission to collect name and address information for your organization, in the "Billing information" section, select the Switch billing account dropdown menu, then click the organization in which you'd like to install the app.

    Screenshot of the GitHub Marketplace app purchase screen. A collapsed blue dropdown menu labeled "Switch billing account" is outlined in dark orange.

    • Otherwise, under "Review your order," select the Account dropdown menu, then click the organization in which you'd like to install the app.

    Screenshot of the GitHub Marketplace app purchase screen. A collapsed gray dropdown menu labeled "Account" is outlined in dark orange.

  6. If you chose a paid plan, review your payment method.

    • To change the existing payment method on file for the organization, click Edit, then complete the form to add a new payment method.
    • If there isn't a payment method on file for the organization, click Add a Payment Method, then complete the form to add a credit card or PayPal account.
  7. Click Complete order and begin installation.

  8. Review the information about the app's access to your personal account, organizations, and data, then click Authorize application.

Further reading