diff --git a/content/admin/github-copilot/copilot-cli/index.md b/content/admin/github-copilot/copilot-cli/index.md deleted file mode 100644 index fde325d3cb73..000000000000 --- a/content/admin/github-copilot/copilot-cli/index.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: GitHub Copilot CLI -shortTitle: '{% data variables.copilot.copilot_cli_short %}' -intro: Configure {% data variables.copilot.copilot_cli_short %} to work with {% data variables.product.prodname_ghe_server %}. -versions: - feature: copilot-cli-ghes -children: - - /set-up-and-use-copilot-cli -docsTeamMetrics: - - copilot-cli ---- diff --git a/content/admin/github-copilot/index.md b/content/admin/github-copilot/index.md deleted file mode 100644 index 975f4a4b897c..000000000000 --- a/content/admin/github-copilot/index.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: GitHub Copilot -intro: Configure and use {% data variables.product.prodname_copilot %} with {% data variables.product.prodname_ghe_server %}. -versions: - feature: copilot-cli-ghes -children: - - /copilot-cli ---- diff --git a/content/admin/index.md b/content/admin/index.md index 7fdb27267256..d4e76f293f05 100644 --- a/content/admin/index.md +++ b/content/admin/index.md @@ -106,7 +106,6 @@ children: - /enforcing-policies - /monitoring-activity-in-your-enterprise - /monitoring-and-managing-your-instance - - /github-copilot - /managing-github-apps-for-your-enterprise - /managing-github-actions-for-your-enterprise - /configuring-packages diff --git a/content/copilot/copilot-on-ghes/about-copilot-on-ghes.md b/content/copilot/copilot-on-ghes/about-copilot-on-ghes.md new file mode 100644 index 000000000000..f6137014c1ce --- /dev/null +++ b/content/copilot/copilot-on-ghes/about-copilot-on-ghes.md @@ -0,0 +1,52 @@ +--- +title: About GitHub Copilot on GitHub Enterprise Server +shortTitle: About Copilot on GHES +intro: 'Most {% data variables.product.prodname_copilot_short %} features require a presence on {% data variables.product.prodname_ghe_cloud %}, but some features are available on {% data variables.product.prodname_ghe_server %}.' +versions: + ghes: '*' +contentType: concepts +category: + - Learn about Copilot +--- + +If your enterprise is primarily hosted on {% data variables.product.prodname_ghe_server %}, you must take extra steps for your developers to use {% data variables.product.prodname_copilot %}. + +{% data variables.product.prodname_copilot %} is available on {% data variables.product.github %}'s cloud-hosted platforms: {% data variables.product.prodname_dotcom_the_website %} and {% data variables.enterprise.data_residency_site %}. + +* {% data variables.product.prodname_copilot_short %} licenses can **only** be assigned to users through one of these platforms. A {% data variables.product.prodname_copilot_short %} license is required for all {% data variables.product.prodname_copilot_short %} functionality, with the exception of local "bring your own key" (BYOK) setups. +* Administrative features such as policies and managed settings are configured on these platforms. +* {% data variables.product.prodname_copilot_short %} features, such as {% data variables.copilot.copilot_chat_short %}, are integrated into these platforms, and **not** into {% data variables.product.prodname_ghe_server %}. + +However, if your enterprise is primarily hosted on {% data variables.product.prodname_ghe_server %}, your developers can still benefit from {% data variables.product.prodname_copilot %}. The following sections explain your options. + +> [!IMPORTANT] +> {% data variables.product.prodname_copilot %} documentation on this version of {% data variables.product.prodname_docs %} is limited to content that applies specifically to {% data variables.product.prodname_ghe_server %}. View documentation for usage and administration on the [{% data variables.product.prodname_ghe_cloud %} version](/enterprise-cloud@latest/copilot) of the site. + +## Assigning licenses on a cloud platform + +Your {% data variables.product.prodname_enterprise %} license also entitles you to an enterprise account on {% data variables.product.prodname_dotcom_the_website %} or {% data variables.enterprise.data_residency_site %}. + +You can use your cloud-hosted enterprise account to assign {% data variables.product.prodname_copilot_short %} licenses to users and configure policies for {% data variables.product.prodname_copilot_short %}. Users will then be able to authenticate to their cloud account to use {% data variables.product.prodname_copilot_short %} in local clients such as {% data variables.copilot.copilot_cli_short %}. + +{% data variables.product.prodname_copilot_short %} will have access to locally checked-out code and files. Users can configure their local [GitHub MCP server](https://github.com/github/github-mcp-server?tab=readme-ov-file#local-github-mcp-server) so that {% data variables.product.prodname_copilot_short %} can connect to your instance and perform actions like opening issues or pull requests. + +If you enable license sync with {% data variables.product.prodname_github_connect %}, each individual will only consume one {% data variables.product.prodname_enterprise %} license, even with an account on both cloud and server. See [AUTOTITLE](/admin/configuring-settings/configuring-github-connect/about-github-connect). + +## Using {% data variables.product.prodname_copilot_short %} in an air-gapped environment + +Alternatively, you can configure {% data variables.copilot.copilot_cli_short %} to work with {% data variables.product.prodname_ghe_server %} in disconnected or air-gapped environments, without connecting to {% data variables.product.github %}'s cloud platforms or requiring a {% data variables.product.prodname_copilot_short %} license. + +{% ifversion copilot-cli-ghes %} + +An administrator configures a model provider for the instance, and users connect {% data variables.copilot.copilot_cli_short %} with their {% data variables.product.prodname_ghe_server %} credentials. + +For more information, see [AUTOTITLE](/copilot/copilot-on-ghes/set-up-copilot-cli). + +> [!NOTE] +> This feature is in {% data variables.release-phases.technical_preview %} and subject to change. + +{% else %} + +To use this feature, upgrade your instance to **version 3.22 or later**, where this feature is available in {% data variables.release-phases.technical_preview %}. + +{% endif %} diff --git a/content/copilot/copilot-on-ghes/index.md b/content/copilot/copilot-on-ghes/index.md new file mode 100644 index 000000000000..514d8a702459 --- /dev/null +++ b/content/copilot/copilot-on-ghes/index.md @@ -0,0 +1,14 @@ +--- +title: '{% data variables.product.prodname_copilot %} on GitHub Enterprise Server' +shortTitle: '{% data variables.product.prodname_copilot_short %} on GHES' +intro: Specific documentation about using {% data variables.product.prodname_copilot %} in a server-hosted enterprise. +versions: + ghes: '*' +redirect_from: + - /admin/github-copilot + - /admin/github-copilot/copilot-cli +children: + - about-copilot-on-ghes + - set-up-copilot-cli +--- + diff --git a/content/admin/github-copilot/copilot-cli/set-up-and-use-copilot-cli.md b/content/copilot/copilot-on-ghes/set-up-copilot-cli.md similarity index 97% rename from content/admin/github-copilot/copilot-cli/set-up-and-use-copilot-cli.md rename to content/copilot/copilot-on-ghes/set-up-copilot-cli.md index ea3f7beed4ab..db486be0a14c 100644 --- a/content/admin/github-copilot/copilot-cli/set-up-and-use-copilot-cli.md +++ b/content/copilot/copilot-on-ghes/set-up-copilot-cli.md @@ -1,15 +1,17 @@ --- -title: Set up and use GitHub Copilot CLI -shortTitle: 'Set up and use {% data variables.copilot.copilot_cli_short %}' +title: Set up GitHub Copilot CLI for GitHub Enterprise Server +shortTitle: Set up {% data variables.copilot.copilot_cli_short %} intro: Configure a model provider for your {% data variables.product.prodname_ghe_server %} instance, then connect {% data variables.copilot.copilot_cli_short %} clients to the instance. allowTitleToDifferFromFilename: true versions: feature: copilot-cli-ghes contentType: how-tos -category: - - Configure Copilot CLI docsTeamMetrics: - copilot-cli +redirect_from: + - /admin/github-copilot/copilot-cli/set-up-and-use-copilot-cli +category: + - Manage Copilot for a team --- > [!NOTE] diff --git a/content/copilot/get-started/about-github-copilot.md b/content/copilot/get-started/about-github-copilot.md index dd27118d5720..470b3d642e52 100644 --- a/content/copilot/get-started/about-github-copilot.md +++ b/content/copilot/get-started/about-github-copilot.md @@ -92,6 +92,8 @@ You can start using {% data variables.product.prodname_copilot_short %} in sever {% data reusables.copilot.plans.subscribe-for-enterprise %} +If you are on **{% data variables.product.prodname_ghe_server %}**, see [AUTOTITLE](/enterprise-server@latest/copilot/copilot-on-ghes/about-copilot-on-ghes). + ## Control for organizations and enterprises If you use {% data variables.product.prodname_copilot_short %} through an organization or enterprise, administrators decide how it can be used. They control which members have access, set policies for which features are available, exclude files that {% data variables.product.prodname_copilot_short %} shouldn't see, and review usage data and audit logs to understand how it's being used. diff --git a/content/copilot/index.md b/content/copilot/index.md index a9d80ebfa634..761b60b29380 100644 --- a/content/copilot/index.md +++ b/content/copilot/index.md @@ -12,6 +12,7 @@ layout: discovery-landing heroImage: /assets/images/banner-images/hero-6 versions: feature: copilot + ghes: '*' children: - /get-started - /concepts @@ -19,6 +20,7 @@ children: - /reference - /tutorials - /responsible-use + - /copilot-on-ghes contentType: landing includedCategories: - Learn about Copilot diff --git a/data/release-notes/enterprise-server/3-17/0.yml b/data/release-notes/enterprise-server/3-17/0.yml index a5da08881b03..1aaa018f2ecc 100644 --- a/data/release-notes/enterprise-server/3-17/0.yml +++ b/data/release-notes/enterprise-server/3-17/0.yml @@ -107,12 +107,6 @@ sections: - | Administrators can use the GHES Management Console to configure repository exports with local storage, reducing reliance on external blob storage and simplifying the migration process. Exports are stored on the GHES disk, and customers can choose how to provide the archive to GitHub Enterprise Importer, including using GitHub-owned blob storage. - - heading: Audit logs - notes: - # https://github.com/github/releases/issues/4939 - - | - Audit log streaming of API requests targeting your enterprise's private assets is generally available. - - heading: Repositories notes: # https://github.com/github/releases/issues/4042 @@ -239,4 +233,6 @@ sections: errata: - | - The "Features" section incorrectly indicated that updated insight views for repositories are available in this release. This feature is unavailable in GitHub Enterprise Server 3.17, and is available from GitHub Enterprise Server 3.19.0. [Updated: 2026-01-12] \ No newline at end of file + The "Features" section incorrectly indicated that updated insight views for repositories are available in this release. This feature is unavailable in GitHub Enterprise Server 3.17, and is available from GitHub Enterprise Server 3.19.0. [Updated: 2026-01-12] + - | + The "Features" section incorrectly indicated that audit log streaming of API requests targeting private enterprise assets was generally available. This feature is unavailable on GitHub Enterprise Server. [Updated: 2026-09-16] \ No newline at end of file