Skip to main content

This version of GitHub Enterprise was discontinued on 2023-07-06. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

About upgrades to new releases

You can benefit from new features and bug fixes for GitHub Enterprise Server by upgrading your enterprise to a newly released version.

GitHub Enterprise Server is constantly improving, with new functionality and bug fixes introduced through feature and patch releases.

Feature releases include new functionality and feature upgrades and typically occur quarterly.

Starting with GitHub Enterprise Server 3.0, all feature releases begin with at least one release candidate. Release candidates are proposed feature releases, with a complete feature set. There may be bugs or issues in a release candidate which can only be found through feedback from customers actually using GitHub Enterprise Server.

You can get early access to the latest features by testing a release candidate as soon as the release candidate is available. You can upgrade to a release candidate from a supported version and can upgrade from the release candidate to later versions when released. You should upgrade any environment running a release candidate as soon as the release is generally available. For more information, see "Upgrade requirements."

Release candidates should be deployed on test or staging environments. As you test a release candidate, please provide feedback by contacting support. For more information, see "GitHub Support documentation."

We'll use your feedback to apply bug fixes and any other necessary changes to create a stable production release. Each new release candidate adds bug fixes for issues found in prior versions. When the release is ready for widespread adoption, GitHub publishes a stable production release.

Warning: The upgrade to a new feature release will cause a few hours of downtime, during which none of your users will be able to use the enterprise. You can inform your users about downtime by publishing a global announcement banner, using your enterprise settings or the REST API. For more information, see "Customizing user messages for your enterprise" and "GitHub Enterprise administration."

Patch releases, which consist of hot patches and bug fixes only, happen more frequently. Patch releases are generally available when first released, with no release candidates. Upgrading to a patch release typically requires less than five minutes of downtime.

To upgrade your enterprise to a new release, see "Release notes" and "Upgrading GitHub Enterprise Server." Because you can only upgrade from a feature release that's at most two releases behind, use the Upgrade assistant to find the upgrade path from your current release version.

Further reading