Upgrade requirements

Before upgrading GitHub Enterprise Server, review these recommendations and requirements to plan your upgrade strategy.


  • 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 Server Clustering, see "Upgrading a cluster" in the GitHub Enterprise Server Clustering Guide for specific instructions unique to clustering.
  • The release notes for GitHub Enterprise Server provide a comprehensive list of new features for every version of GitHub Enterprise Server. For more information, see the releases page.


  • Include as few upgrades as possible in your upgrade process. For example, instead of upgrading from GitHub Enterprise 3.1 to 3.2 to 3.3, you could upgrade from GitHub Enterprise 3.1 to 3.3.
  • If you’re several versions behind, upgrade your GitHub Enterprise Server 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. 浏览到 GitHub Enterprise Server 发行版页面。 在要升级到的版本旁边,单击 Download(下载),然后单击 Upgrading(升级)选项卡。
  • 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 upgrade tasks running in the background to fully complete.


  • You must upgrade from a feature release that's at most two releases behind. For example, to upgrade to GitHub Enterprise 3.3, you must be on GitHub Enterprise 3.2 or 3.1.
  • 您可以使用热更新将 GitHub Enterprise Server 升级为最新的补丁版本,它不需要维护时间窗,通常不需要重启。 您可以使用热更新来升级到更新的补丁版本,但不能升级到功能版本。 例如,您可以从 2.10.1 升级到 2.10.5,因为它们属于相同的功能系列,但不能从 2. 0.9 升级到 2.11.0,因为它们处于不同的功能系列中。
  • A hotpatch may require downtime if the affected services (like kernel, MySQL, or Elasticsearch) require a VM reboot or a service restart. You'll be notified when a reboot or restart is required. You can complete the reboot or restart at a later time.
  • Additional root storage must be available when upgrading through hotpatching, as it installs multiple versions of certain services until the upgrade is complete. Pre-flight checks will notify you if you don't have enough root disk storage.
  • When upgrading through hotpatching, your instance cannot be too heavily loaded, as it may impact the hotpatching process. Pre-flight checks will consider the load average and the upgrade will fail if the load average is too high.- Upgrading to GitHub Enterprise Server 2.17 migrates your audit logs from Elasticsearch to MySQL. This migration also increases the amount of time and disk space it takes to restore a snapshot. Before migrating, check the number of bytes in your Elasticsearch audit log indices with this command:
    curl -s http://localhost:9201/audit_log/_stats/store | jq ._all.primaries.store.size_in_bytes
    Use the number to estimate the amount of disk space the MySQL audit logs will need. The script also monitors your free disk space while the import is in progress. Monitoring this number is especially useful if your free disk space is close to the amount of disk space necessary for migration.

关于 GitHub Enterprise Server 3.0 及更高版本的最低要求

升级到 GitHub Enterprise Server 3.0 或更高版本之前,请检查您为实例预配的硬件资源。 GitHub Enterprise Server 3.0 引入了 GitHub Actions 和 GitHub Packages 等新功能,比 2.22 和更早版本需要更多的资源。 更多信息请参阅 GitHub Enterprise Server 3.0 发行说明

GitHub Enterprise Server 3.0 及更高版本的增加要求在下表中以粗体表示。

试用版、演示版或 10 个轻度用户4
Up from 2
32 GB
Up from 16 GB
150 GB
Up from 100 GB
200 GB
Up from 4
48 GB
Up from 32 GB
300 GB
Up from 250 GB
200 GB
Up from 8
64 GB500 GB200 GB
Up from 12
96 GB750 GB200 GB
Up from 16
160 GB
Up from 128 GB
1000 GB200 GB

有关 GitHub Actions 硬件要求的详细信息,请参阅“GitHub Enterprise Server 的 GitHub Actions 使用入门”。

有关为现有实例调整资源的更多信息,请参阅“增加存储容量”和“增加 CPU 或内存资源”。

Next steps

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




所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。


或者, 了解如何参与。