| title | GitHub Enterprise Server releases | ||
|---|---|---|---|
| intro | Review information for each version of {% data variables.product.prodname_ghe_server %}: {% data variables.release-phases.closing_down %} dates, links to documentation, and minimum recommended versions of supporting applications. | ||
| allowTitleToDifferFromFilename | true | ||
| versions |
|
||
| shortTitle | Releases | ||
| category |
|
{% data reusables.enterprise.constantly-improving %} See AUTOTITLE.
{% data variables.product.company_short %} supports at least the four most recent feature releases.
We provide documentation for both supported and unsupported versions of {% data variables.product.prodname_ghe_server %}. We do not maintain or update the documentation for unsupported versions.
For information about the latest release, see the {% data variables.product.prodname_enterprise %} website.
| Version | Candidate | Release | {% data variables.release-phases.closing_down_caps %} date | Supported | Release notes | Docs |
|---|---|---|---|---|---|---|
| {%- for version in enterpriseServerReleases.supported %} | ||||||
| {%- assign currentDate = 'now' | date: '%s' %} | |||||
| {%- assign deprecationDate = enterpriseServerReleases.dates[version].deprecationDate | date: '%s' %} | |||||
| {{version}} | {{enterpriseServerReleases.dates[version].displayCandidateDate}} | {{enterpriseServerReleases.dates[version].displayReleaseDate}} | {{enterpriseServerReleases.dates[version].deprecationDate}} | {% if currentDate < deprecationDate %}{% octicon "check" aria-label="Supported" %}{% else %}{% octicon "x" aria-label="Not supported" %}{% endif %} | {{version}} release notes | {{version}} docs |
| {%- endfor %} | ||||||
| {%- for version in enterpriseServerReleases.deprecatedReleasesWithNewFormat %} | ||||||
| {%- assign candidateDisplay = enterpriseServerReleases.dates[version].displayCandidateDate | default: enterpriseServerReleases.dates[version].releaseDate %} | |||||
| {%- assign releaseDisplay = enterpriseServerReleases.dates[version].displayReleaseDate | default: enterpriseServerReleases.dates[version].releaseDate %} | |||||
| {{version}} | {{candidateDisplay}} | {{releaseDisplay}} | {{enterpriseServerReleases.dates[version].deprecationDate}} | {% octicon "x" aria-label="Not supported" %} | {{version}} release notes | {{version}} docs |
| {%- endfor %} | ||||||
| {%- for version in enterpriseServerReleases.deprecatedReleasesWithLegacyFormat %} | ||||||
| {%- assign candidateDisplay = enterpriseServerReleases.dates[version].displayCandidateDate | default: enterpriseServerReleases.dates[version].releaseDate %} | |||||
| {%- assign releaseDisplay = enterpriseServerReleases.dates[version].displayReleaseDate | default: enterpriseServerReleases.dates[version].releaseDate %} | |||||
| {{version}} | {{candidateDisplay}} | {{releaseDisplay}} | {{enterpriseServerReleases.dates[version].deprecationDate}} | {% octicon "x" aria-label="Not supported" %} | {{version}} release notes | {{version}} docs |
| {%- endfor %} |
We hosted developer documentation for {% data variables.product.prodname_ghe_server %} on a separate site until the 2.17 release. We provide developer documentation for version 2.16 and earlier, but do not maintain or update the documentation.
| Version | Candidate | Release | {% data variables.release-phases.closing_down_caps %} date | Developer docs |
|---|---|---|---|---|
| {%- for version in enterpriseServerReleases.deprecatedReleasesOnDeveloperSite %} | ||||
| {%- assign candidateDisplay = enterpriseServerReleases.dates[version].displayCandidateDate | default: enterpriseServerReleases.dates[version].releaseDate %} | |||
| {%- assign releaseDisplay = enterpriseServerReleases.dates[version].displayReleaseDate | default: enterpriseServerReleases.dates[version].releaseDate %} | |||
| {{version}} | {{candidateDisplay}} | {{releaseDisplay}} | {{enterpriseServerReleases.dates[version].deprecationDate}} | {{version}} developer docs |
| {%- endfor %} |
For instances with a {% data variables.product.prodname_GHAS_or_code_security %} license and {% data variables.product.prodname_code_scanning %} enabled, the {% data variables.product.prodname_codeql %} action for {% data variables.product.prodname_code_scanning %} analysis uses a minimum recommended version of the {% data variables.product.prodname_codeql_cli %} by default.
If you run analysis in an external CI system, we recommend using the same version of the {% data variables.product.prodname_codeql_cli %}. See AUTOTITLE.
| {% data variables.product.prodname_ghe_server %} version | Recommended {% data variables.product.prodname_codeql_cli %} version |
|---|---|
| 3.20 | 2.23.9 (changelog) |
| 3.19 | 2.22.4 (changelog) |
| 3.18 | 2.21.4 (changelog) |
| 3.17 | 2.20.7 (changelog) |
| 3.16 | 2.20.3 (changelog) |
| 3.15 | 2.18.4 (changelog) |
| 3.14 | 2.17.6 (changelog) |
| 3.13 | 2.16.5 (changelog) |
| 3.12 | 2.15.5 (changelog) |
| 3.11 | 2.14.6 (changelog) |
| 3.10 | 2.13.5 (changelog) |
| 3.9 | 2.12.7 (changelog) |
For instances with {% data variables.product.prodname_actions %} enabled, self-hosted {% data variables.product.prodname_actions %} runners must run a minimum required version of the {% data variables.product.prodname_actions %} Runner application.
- For most instances, the Runner application is updated automatically.
- If your instance uses ephemeral self-hosted runners and you've disabled automatic updates, you must upgrade your runners before upgrading {% data variables.product.prodname_ghe_server %}. See AUTOTITLE.
| {% data variables.product.prodname_ghe_server %} version | Minimum Runner version |
|---|---|
| 3.20 | 2.330.0 (release notes) |
| 3.19 | 2.328.0 (release notes) |
| 3.18 | 2.324.0 (release notes) |
| 3.17 | 2.322.0 (release notes) |
| 3.16 | 2.321.0 (release notes) |
| 3.15 | 2.319.1 (release notes) |
| 3.14 | 2.317.0 (release notes) |
| 3.13 | 2.314.1 (release notes) |
| 3.12 | 2.311.0 (release notes) |
| 3.11 | 2.309.0 (release notes) |
| 3.10 | 2.304.0 (release notes) |
| 3.9 | 2.303.0 (release notes) |