Before upgrading GitHub Enterprise, review these recommendations and requirements.

Upgrading strategy

Notes:

  • To upgrade from GitHub Enterprise 11.10.348 through 11.10.354, you must first migrate to GitHub Enterprise 2.1.23. For more information, see "Migrating from GitHub Enterprise 11.10.x to 2.1.23."
  • Upgrade packages are available at enterprise.github.com for supported versions. Verify the availability of the upgrade packages you will need to complete the upgrade. If a package is not available, contact GitHub Enterprise Support for assistance.
  • If you're using GitHub Enterprise Clustering, see "Upgrading a cluster" in the GitHub Enterprise Clustering Guide for specific instructions unique to clustering.

Recommendations

  • Include as few upgrades as possible in your upgrade process. For example, instead of upgrading from GitHub Enterprise 2.11 to 2.12 to 2.13, you could upgrade from GitHub Enterprise 2.11 to 2.13.
  • If you’re several versions behind, upgrade your GitHub Enterprise instance as far forward as possible with each step of your upgrade process. Using the latest version possible on each upgrade allows you to take advantage of performance improvements and bug fixes. For example, you could upgrade from GitHub Enterprise 2.7 to 2.8 to 2.10, but upgrading from GitHub Enterprise 2.7 to 2.9 to 2.10 uses a later version in the second step.
  • Use the latest patch release when upgrading. Browse to the GitHub Enterprise Releases page, on the right side next to the release you are upgrading to, click Download, then click the Upgrading tab.
  • Use a staging instance to test the upgrade steps. For more information, see "Setting up a staging instance."
  • When running multiple upgrades, wait at least 24 hours between feature upgrades to allow data migrations and backgrounded upgrade tasks to fully complete.

Requirements

  • You must upgrade from a feature release that's at most two releases behind. For example, to upgrade to GitHub Enterprise 2.13, you must be on GitHub Enterprise 2.12 or 2.11.
  • Hotpatching was available in GitHub Enterprise 2.10 as part of the Early Access Program and is now available as a general release feature in GitHub Enterprise 2.11.

After reviewing these recommendations and requirements you can upgrade GitHub Enterprise. For more information, see "Upgrading GitHub Enterprise."