Skip to content

Latest commit

 

History

History
81 lines (53 loc) · 5.63 KB

viewing-license-usage-for-github-enterprise.md

File metadata and controls

81 lines (53 loc) · 5.63 KB
title intro permissions versions type topics shortTitle
Viewing license usage for GitHub Enterprise
You can view license usage for your enterprise on {% ifversion ghec %}{% data variables.product.prodname_ghe_cloud %}{% elsif ghes %}{% data variables.location.product_location %}{% endif %}.
Enterprise owners{% ifversion ghec %} and billing managers{% endif %}
ghec ghes
*
*
how_to
Enterprise
Licensing
View license usage

{% ifversion enhanced-billing-platform %}

{% data reusables.billing.enhanced-billing-platform-licenses %}

{% endif %}

About license usage for {% data variables.product.prodname_enterprise %}

You can view license usage for {% data variables.product.prodname_enterprise %} on {% data variables.product.github %}.

If you use both {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_ghe_server %} and sync license usage between the products, you can view license usage for both on {% data variables.product.prodname_ghe_cloud %}. For more information about license sync, see AUTOTITLE.

{% ifversion ghes %}

For more information about viewing license usage on {% data variables.product.prodname_ghe_cloud %} and identifying when the last license sync occurred, see AUTOTITLE in the {% data variables.product.prodname_ghe_cloud %} documentation.

{% endif %}

You can also use the REST API to return consumed licenses data and the status of the license sync job. See AUTOTITLE.

To learn more about the license data associated with your enterprise account and how the number of consumed user licenses are calculated, see AUTOTITLE.

{% ifversion enterprise-member-csv %}

The licensing report includes all users who currently hold a {% data variables.product.prodname_enterprise %} (GHE) license or will be billed in this month's billing cycle. This report is ideal for tracking current and billable license usage, ensuring accurate license counts, and identifying users consuming GHE licenses. For a full list of all members associated with the enterprise, see AUTOTITLE.

{% endif %}

Viewing license usage on {% ifversion ghec %}{% data variables.product.prodname_ghe_cloud %}{% elsif ghes %}{% data variables.location.product_location %}{% endif %}

{% ifversion ghec %}

You can view the license usage for your enterprise and download a file with license details. If you're not seeing expected license counts in this report, it's possible that the subscriber’s assigned {% data variables.product.prodname_vs %} subscription email address and {% data variables.product.prodname_dotcom_the_website %} email address aren't exactly the same. For further information, see AUTOTITLE.

{% data reusables.enterprise-accounts.access-enterprise-on-dotcom %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.license-tab %}

  1. Review your current {% data variables.product.prodname_enterprise %} license, as well as consumed and available user licenses.

    • If you purchased {% data variables.product.prodname_AS %}, you can review your total license usage. To learn about the information displayed, see AUTOTITLE.

  2. To download a CSV report of the license usage, click {% octicon "kebab-horizontal" aria-label="Licensing dropdown" %} to the right of the usage you want to download, then click {% octicon "download" aria-hidden="true" %} CSV report.

{% elsif ghes %}

{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.license-tab %}

  1. Review your current {% data variables.product.prodname_enterprise %} license, as well as consumed and available user licenses.

    If you have purchased {% data variables.product.prodname_AS %}, you can review your total licenses used as well as a per-organization breakdown of active committers. See AUTOTITLE.

{% endif %}

{% ifversion ghec %}

Viewing the last license sync date

{% data reusables.enterprise-accounts.access-enterprise-on-dotcom %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.license-tab %}

  1. To identify when the last license sync occurred, under "Enterprise Server instances", look for timestamps next to usage uploaded or synced events.
    • "Server usage uploaded" indicates license usage between environments was manually updated when a {% data variables.product.prodname_ghe_server %} license file was uploaded.
    • "{% data variables.product.prodname_github_connect %} server usage synced" indicates license usage between environments was automatically updated.
    • "{% data variables.product.prodname_github_connect %} server usage never synced" indicates that {% data variables.product.prodname_github_connect %} is configured, but license usage between environments has never updated successfully.

{% endif %}