Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 0 additions & 11 deletions content/admin/github-copilot/copilot-cli/index.md

This file was deleted.

8 changes: 0 additions & 8 deletions content/admin/github-copilot/index.md

This file was deleted.

1 change: 0 additions & 1 deletion content/admin/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
52 changes: 52 additions & 0 deletions content/copilot/copilot-on-ghes/about-copilot-on-ghes.md
Original file line number Diff line number Diff line change
@@ -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 %}
14 changes: 14 additions & 0 deletions content/copilot/copilot-on-ghes/index.md
Original file line number Diff line number Diff line change
@@ -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
---

Original file line number Diff line number Diff line change
@@ -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]
Expand Down
2 changes: 2 additions & 0 deletions content/copilot/get-started/about-github-copilot.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
2 changes: 2 additions & 0 deletions content/copilot/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,13 +12,15 @@ layout: discovery-landing
heroImage: /assets/images/banner-images/hero-6
versions:
feature: copilot
ghes: '*'
children:
- /get-started
- /concepts
- /how-tos
- /reference
- /tutorials
- /responsible-use
- /copilot-on-ghes
contentType: landing
includedCategories:
- Learn about Copilot
Expand Down
10 changes: 3 additions & 7 deletions data/release-notes/enterprise-server/3-17/0.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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]
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]
Loading