You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
title: Syncing license usage from GitHub Enterprise Server to Cloud
3
-
intro: 'You can sync license usage from GitHub Enterprise Server to GitHub Enterprise Cloud to view all license usage across your enterprise in one place and ensure that people with accounts in both environments only consume one user license.'
4
-
permissions: 'Enterprise owners can sync license usage between enterprise accounts on {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %}.'
3
+
intro: 'Sync licenses manually or with {% data variables.product.prodname_github_connect %}.'
5
4
versions:
6
5
ghec: '*'
7
6
ghes: '*'
@@ -15,28 +14,28 @@ redirect_from:
15
14
contentType: how-tos
16
15
---
17
16
18
-
## About synchronization of license usage
17
+
A {% data variables.product.prodname_enterprise %} license allows a user to use both {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_ghe_server %}. See [AUTOTITLE](/billing/concepts/enterprise-billing/combined-enterprise-use).
19
18
20
-
{% data reusables.enterprise-licensing.unique-user-licensing-model %}
19
+
To view combined license details on {% data variables.product.prodname_ghe_cloud %} and ensure users only consume one license, you must sync licenses between deployments. You can do this:
21
20
22
-
{% data reusables.enterprise-licensing.about-license-sync %}
23
-
24
-
To ensure that you see up-to-date license details on {% data variables.product.prodname_ghe_cloud %}, you can sync license usage to {% data variables.product.prodname_dotcom_the_website %}{% ifversion ghecom-license-sync %} or {% data variables.enterprise.data_residency_site %}{% endif %} automatically, using {% data variables.product.prodname_github_connect %}. For more information about {% data variables.product.prodname_github_connect %}, see [About {% data variables.product.prodname_github_connect %}]({% ifversion ghec %}/enterprise-server@latest{% endif %}/admin/configuration/configuring-github-connect/about-github-connect){% ifversion ghec %} in the {% data variables.product.prodname_ghe_server %} documentation.{% elsif ghes %}.{% endif %}
25
-
26
-
If you don't want to enable {% data variables.product.prodname_github_connect %}, you can manually sync license usage by uploading a file from {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_dotcom_the_website %}.
21
+
* Automatically, using {% data variables.product.prodname_github_connect %}.
22
+
* Manually, by uploading a license file from from {% data variables.product.prodname_ghe_server %} to {% data variables.product.github %}.
27
23
28
24
When you synchronize license usage, only the user ID and email addresses for each user account on {% data variables.product.prodname_ghe_server %} are transmitted to {% data variables.product.prodname_ghe_cloud %}.
29
25
30
-
{% data reusables.enterprise-licensing.view-consumed-licenses %}
31
-
32
-
{% data reusables.enterprise-licensing.verified-domains-license-sync %}
33
-
34
26
## Automatically syncing license usage
35
27
36
28
You can use {% data variables.product.prodname_github_connect %} to automatically synchronize user license count and usage between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %} weekly.
37
29
38
30
After you enable {% data variables.product.prodname_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.
39
31
32
+
### Enabling automatic license sync
33
+
34
+
To enable license sync, you must:
35
+
36
+
1. Enable {% data variables.product.prodname_github_connect %}. See {% ifversion ghes %}[AUTOTITLE](/admin/configuring-settings/configuring-github-connect/enabling-github-connect-for-githubcom) or [AUTOTITLE](/admin/configuring-settings/configuring-github-connect/enabling-github-connect-for-ghecom){% else %}[AUTOTITLE](/enterprise-server@latest/admin/configuring-settings/configuring-github-connect/enabling-github-connect-for-githubcom) or [AUTOTITLE](/enterprise-server@latest/admin/configuring-settings/configuring-github-connect/enabling-github-connect-for-ghecom) in the {% data variables.product.prodname_ghe_server %} documentation{% endif %}.
37
+
1. Enable license sync. See {% ifversion ghes %}[AUTOTITLE](/admin/configuring-settings/configuring-github-connect/enabling-automatic-user-license-sync-for-your-enterprise){% else %}[AUTOTITLE](/enterprise-server@latest/admin/configuring-settings/configuring-github-connect/enabling-github-connect-for-githubcom) in the {% data variables.product.prodname_ghe_server %} documentation{% endif %}.
38
+
40
39
### Triggering a license sync job
41
40
42
41
1. Sign in to your {% data variables.product.prodname_ghe_server %} instance.
@@ -45,9 +44,7 @@ After you enable {% data variables.product.prodname_github_connect %}, license d
45
44
{% data reusables.enterprise-accounts.license-tab-ghes %}
If there is no **{% octicon "sync" aria-hidden="true" aria-label="sync" %} Sync now** button, you need to enable license synchronization. An information message, "License sync is disabled. You can enable it in the GitHub Connect settings" is shown. Click the "GitHub Connect settings" link. For more information, see [Enabling automatic user license sync for your enterprise]({% ifversion ghec %}/enterprise-server@latest{% endif %}/admin/configuration/configuring-github-connect/enabling-automatic-user-license-sync-for-your-enterprise){% ifversion ghec %} in the {% data variables.product.prodname_ghe_server %} documentation.{% elsif ghes %}.{% endif %}
49
-
50
-
## Manually uploading GitHub Enterprise Server license usage
47
+
## Manually uploading {% data variables.product.prodname_ghe_server %} license usage
51
48
52
49
You can download a JSON file from {% data variables.product.prodname_ghe_server %} and upload the file to {% data variables.product.prodname_ghe_cloud %} to manually sync user license usage between the two deployments.
53
50
@@ -62,3 +59,9 @@ You can download a JSON file from {% data variables.product.prodname_ghe_server
62
59
{% data reusables.enterprise-accounts.licensing-tab-both-platforms %}
63
60
1. Next to "Enterprise Server instances", click **Add server usage**.
64
61
1. Upload the JSON file you downloaded from {% data variables.product.prodname_ghe_server %}.
62
+
63
+
## Next steps
64
+
65
+
{% data reusables.enterprise-licensing.view-consumed-licenses %}
66
+
67
+
To make troubleshooting easier, if you synchronize license usage and do not use {% data variables.product.prodname_emus %}, we highly recommend enabling verified domains for your enterprise account on {% data variables.product.prodname_ghe_cloud %}. See [AUTOTITLE](/enterprise-cloud@latest/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise){% ifversion ghes %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}.{% endif %}
0 commit comments