Skip to main content

Sincronizando o uso da licença entre o GitHub Enterprise Server e o GitHub Enterprise Cloud

Você pode sincronizar o uso da licença de GitHub Enterprise Server com GitHub Enterprise Cloud para ver todas as licenças usadas por toda a sua empresa em um só lugar e garantir que as pessoas com contas em ambos os ambientes consomem apenas uma licença de usuário.

Quem pode usar esse recurso?

Enterprise owners can sync license usage between enterprise accounts on GitHub Enterprise Server and GitHub Enterprise Cloud.

About synchronization of license usage

GitHub uses a unique-user licensing model. For enterprise products that include multiple deployment options, GitHub determines how many licensed seats you're consuming based on the number of unique users across all your deployments.

Each user only consumes one license, no matter how many GitHub Enterprise Server instances the user uses, or how many organizations the user is a member of on GitHub Enterprise Cloud. This model allows each person to use multiple GitHub Enterprise deployments without incurring extra costs.

For a person using multiple GitHub Enterprise environments to only consume a single license, you must synchronize license usage between environments. Then, GitHub will deduplicate users based on the email addresses associated with their user accounts. GitHub deduplicates licenses for the GitHub Enterprise plan itself, and for GitHub Advanced Security. For more information, see "Troubleshooting license usage for GitHub Enterprise."

To ensure that you see up-to-date license details on GitHub.com, you can sync license usage between the environments automatically, using GitHub Connect. For more information about GitHub Connect, see "About GitHub Connect."

If you don't want to enable GitHub Connect, you can manually sync license usage by uploading a file from GitHub Enterprise Server to GitHub.com.

When you synchronize license usage, only the user ID and email addresses for each user account on GitHub Enterprise Server are transmitted to GitHub Enterprise Cloud.

After you synchronize license usage, you can see a report of consumed licenses across all your environments in the enterprise settings on GitHub Enterprise Cloud. For more information, see "Viewing license usage for GitHub Enterprise."

Note

To make troubleshooting easier, if you synchronize license usage and do not use Enterprise Managed Users, we highly recommend enabling verified domains for your enterprise account on GitHub Enterprise Cloud. See "Verifying or approving a domain for your enterprise" in the GitHub Enterprise Cloud documentation.

Automatically syncing license usage

You can use GitHub Connect to automatically synchronize user license count and usage between GitHub Enterprise Server and GitHub Enterprise Cloud weekly. For more information, see "Enabling automatic user license sync for your enterprise."

After you enable GitHub Connect, license data will be automatically synchronized weekly. You can also manually synchronize your license data at any time, by triggering a license sync job.

Triggering a license sync job

  1. Sign in to your GitHub Enterprise Server instance.

  2. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.

    Screenshot of the drop-down menu that appears when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is highlighted in a dark orange outline.

  3. In the enterprise account sidebar, click Settings.

  4. Under Settings, click License.

  5. Under "License sync", click Sync now.

Manually uploading GitHub Enterprise Server license usage

You can download a JSON file from GitHub Enterprise Server and upload the file to GitHub Enterprise Cloud to manually sync user license usage between the two deployments.

  1. Sign in to your GitHub Enterprise Server instance.

  2. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.

    Screenshot of the drop-down menu that appears when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is highlighted in a dark orange outline.

  3. In the enterprise account sidebar, click Settings.

  4. Under Settings, click License.

  5. In the "User licenses" section, under "Quick links", to download a file containing your current license usage on GitHub Enterprise Server, click Export license usage.

    Screenshot of the "User licenses" section of the "License" page. A link, labeled "Export license usage", is outlined in dark orange.

  6. Navigate to GitHub Enterprise Cloud.

  7. In the top-right corner of GitHub, click your profile photo, then click Your enterprises.

  8. In the list of enterprises, click the enterprise you want to view.

  9. In the enterprise account sidebar, click Settings.

  10. Under Settings, click License.

  11. Next to "Enterprise Server instances", click Add server usage.

  12. Upload the JSON file you downloaded from GitHub Enterprise Server.