From ec6443567885d02e84c4b02d6ca312d2ad1ac451 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 29 Apr 2026 14:54:58 +0800 Subject: [PATCH 1/5] Add temp.md --- temp.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 temp.md diff --git a/temp.md b/temp.md new file mode 100644 index 0000000000000..af27ff4986a7b --- /dev/null +++ b/temp.md @@ -0,0 +1 @@ +This is a test file. \ No newline at end of file From 1e03151025b0ad868704795628a22f56b1321476 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 29 Apr 2026 14:55:05 +0800 Subject: [PATCH 2/5] Delete temp.md --- temp.md | 1 - 1 file changed, 1 deletion(-) delete mode 100644 temp.md diff --git a/temp.md b/temp.md deleted file mode 100644 index af27ff4986a7b..0000000000000 --- a/temp.md +++ /dev/null @@ -1 +0,0 @@ -This is a test file. \ No newline at end of file From 32ac1566930f6eac70f15785cb401f15498e5d97 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 29 Apr 2026 06:57:29 +0000 Subject: [PATCH 3/5] Auto-sync: Update English docs from Chinese PR Synced from: https://github.com/pingcap/docs-cn/pull/21597 Target PR: https://github.com/pingcap/docs/pull/22832 AI Provider: gemini Co-authored-by: github-actions[bot] --- hardware-and-software-requirements.md | 192 ++++++++++++-------------- 1 file changed, 88 insertions(+), 104 deletions(-) diff --git a/hardware-and-software-requirements.md b/hardware-and-software-requirements.md index fc94868b9dbd1..e0b0c9db549f1 100644 --- a/hardware-and-software-requirements.md +++ b/hardware-and-software-requirements.md @@ -17,110 +17,94 @@ This document describes the software and hardware requirements for deploying and ## OS and platform requirements -In v8.5 LTS, TiDB ensures multi-level quality standards for various combinations of operating systems and CPU architectures. - -+ For the following combinations of operating systems and CPU architectures, TiDB **provides enterprise-level production quality**, and the product features have been comprehensively and systematically verified: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Operating systemsSupported CPU architectures
Red Hat Enterprise Linux 8.4 or a later 8.x version
  • x86_64
  • ARM 64
Amazon Linux 2
  • x86_64
  • ARM 64
Amazon Linux 2023
  • x86_64
  • ARM 64
Rocky Linux 9.1 or later
  • x86_64
  • ARM 64
Kylin V10 SP1/SP2/SP3 (SP3 is supported starting from v7.5.5)
  • x86_64
  • ARM 64
UnionTech OS (UOS) V20
  • x86_64
  • ARM 64
openEuler 22.03 LTS SP1/SP3
  • x86_64
  • ARM 64
- - > **Warning:** - > - > - According to [CentOS Linux EOL](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/), the upstream support for CentOS Linux 7 ended on June 30, 2024. - > - Before upgrading TiDB, make sure to check your operating system version. TiDB v8.4.0 DMR and v8.5.0 removed the support of glibc 2.17, and dropped support and testing with CentOS Linux 7. It is recommended to use Rocky Linux 9.1 or a later version. Upgrading a TiDB cluster on CentOS 7 to v8.4.0 or v8.5.0 will cause the risk of cluster unavailability. - > - Starting from v8.5.1, to assist users still using CentOS Linux 7, TiDB resumes the support of glibc 2.17, resumes testing of CentOS Linux 7, and is now compatible with CentOS Linux 7. However, due to the EOL status of CentOS Linux, it is strongly recommended that you review the [official announcements and security guidance](https://www.redhat.com/en/blog/centos-linux-has-reached-its-end-life-eol) for CentOS Linux 7 and migrate to an operating system supported by TiDB for production use, such as Rocky Linux 9.1 or later. - > - According to [Red Hat Enterprise Linux Life Cycle](https://access.redhat.com/support/policy/updates/errata/#Life_Cycle_Dates), the maintenance support for Red Hat Enterprise Linux 7 ended on June 30, 2024. TiDB ends the support for Red Hat Enterprise Linux 7 starting from the 8.4 DMR version. It is recommended to use Rocky Linux 9.1 or a later version. Upgrading a TiDB cluster on Red Hat Enterprise Linux 7 to v8.4.0 or later will cause the cluster to become unavailable. Before upgrading TiDB, make sure to check your operating system version. - -+ For the following combinations of operating systems and CPU architectures, you can compile, build, and deploy TiDB. In addition, you can also use the basic features of OLTP, OLAP, and the data tools. However, because these combinations have not undergone comprehensive and systematic testing, TiDB **does not guarantee enterprise-level production quality**: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Operating systemsSupported CPU architectures
macOS 12 (Monterey) or later
  • x86_64
  • ARM 64
Oracle Enterprise Linux 8 or a laterx86_64
Ubuntu LTS 20.04 or laterx86_64
CentOS Stream 8
  • x86_64
  • ARM 64
Debian 10 (Buster) or laterx86_64
Fedora 38 or laterx86_64
openSUSE Leap later than v15.5 (not including Tumbleweed)x86_64
SUSE Linux Enterprise Server 15x86_64
- - > **Note:** - > - > - For Oracle Enterprise Linux, TiDB supports the Red Hat Compatible Kernel (RHCK) and does not support the Unbreakable Enterprise Kernel provided by Oracle Enterprise Linux. - > - Support for Ubuntu 16.04 will be removed in future versions of TiDB. Upgrading to Ubuntu 18.04 or later is strongly recommended. - > - CentOS Stream 8 reaches [End of Builds](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/) on May 31, 2024. - -+ If you are using the 32-bit version of an operating system listed in the preceding two tables, TiDB **is not guaranteed** to be compilable, buildable or deployable on the 32-bit operating system and the corresponding CPU architecture, or TiDB does not actively adapt to the 32-bit operating system. - -+ Other operating system versions not mentioned above might work but are not officially supported. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Operating systemsSupported CPU architectures
Red Hat Enterprise Linux 9.4 or a later 9.x version
  • x86_64
  • ARM 64
Red Hat Enterprise Linux 8.6 or a later 8.x version
  • x86_64
  • ARM 64
Amazon Linux 2
  • x86_64
  • ARM 64
Amazon Linux 2023
  • x86_64
  • ARM 64
Rocky Linux 9.1 or later
  • x86_64
  • ARM 64
Kylin V10 SP1/SP2/SP3 (SP3 is supported starting from v7.5.5)
  • x86_64
  • ARM 64
UnionTech OS (UOS) V20
  • x86_64
  • ARM 64
openEuler 24.03 LTS (SP4 or later)
  • x86_64
  • ARM 64
macOS 14 (Sonoma) or later
  • x86_64
  • ARM 64
Oracle Enterprise Linux 8 or laterx86_64
Ubuntu LTS 22.04 or laterx86_64
CentOS Stream 9
  • x86_64
  • ARM 64
Debian 12 (Bookworm) or laterx86_64
Fedora 42 or laterx86_64
openSUSE Leap later than v15.6 (not including Tumbleweed)x86_64
SUSE Linux Enterprise Server 15.6 or laterx86_64
+ +> **Warning:** +> +> - TiDB requires a 64-bit CPU architecture. +> - Other operating system versions not mentioned above might work but are not officially supported. + +> **Note:** +> +> Support for Red Hat Enterprise Linux 9.x versions starts from [TiUP](https://github.com/pingcap/tiup/releases) v1.16.5. + +> **Note:** +> +> - For Oracle Enterprise Linux, TiDB supports the Red Hat Compatible Kernel (RHCK) and does not support the Unbreakable Enterprise Kernel provided by Oracle Enterprise Linux. +> - Starting from v8.4.0, TiDB requires glibc 2.28. If your glibc version does not meet this requirement, it is recommended to use an operating system listed in the preceding table or upgrade the operating system to a version that supports glibc 2.28. ### Libraries required for compiling and running TiDB From 7dee2b9ea0edf165795767c7673f2168e0138fbe Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 29 Apr 2026 15:01:44 +0800 Subject: [PATCH 4/5] Discard changes to hardware-and-software-requirements.md --- hardware-and-software-requirements.md | 192 ++++++++++++++------------ 1 file changed, 104 insertions(+), 88 deletions(-) diff --git a/hardware-and-software-requirements.md b/hardware-and-software-requirements.md index e0b0c9db549f1..fc94868b9dbd1 100644 --- a/hardware-and-software-requirements.md +++ b/hardware-and-software-requirements.md @@ -17,94 +17,110 @@ This document describes the software and hardware requirements for deploying and ## OS and platform requirements - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Operating systemsSupported CPU architectures
Red Hat Enterprise Linux 9.4 or a later 9.x version
  • x86_64
  • ARM 64
Red Hat Enterprise Linux 8.6 or a later 8.x version
  • x86_64
  • ARM 64
Amazon Linux 2
  • x86_64
  • ARM 64
Amazon Linux 2023
  • x86_64
  • ARM 64
Rocky Linux 9.1 or later
  • x86_64
  • ARM 64
Kylin V10 SP1/SP2/SP3 (SP3 is supported starting from v7.5.5)
  • x86_64
  • ARM 64
UnionTech OS (UOS) V20
  • x86_64
  • ARM 64
openEuler 24.03 LTS (SP4 or later)
  • x86_64
  • ARM 64
macOS 14 (Sonoma) or later
  • x86_64
  • ARM 64
Oracle Enterprise Linux 8 or laterx86_64
Ubuntu LTS 22.04 or laterx86_64
CentOS Stream 9
  • x86_64
  • ARM 64
Debian 12 (Bookworm) or laterx86_64
Fedora 42 or laterx86_64
openSUSE Leap later than v15.6 (not including Tumbleweed)x86_64
SUSE Linux Enterprise Server 15.6 or laterx86_64
- -> **Warning:** -> -> - TiDB requires a 64-bit CPU architecture. -> - Other operating system versions not mentioned above might work but are not officially supported. - -> **Note:** -> -> Support for Red Hat Enterprise Linux 9.x versions starts from [TiUP](https://github.com/pingcap/tiup/releases) v1.16.5. - -> **Note:** -> -> - For Oracle Enterprise Linux, TiDB supports the Red Hat Compatible Kernel (RHCK) and does not support the Unbreakable Enterprise Kernel provided by Oracle Enterprise Linux. -> - Starting from v8.4.0, TiDB requires glibc 2.28. If your glibc version does not meet this requirement, it is recommended to use an operating system listed in the preceding table or upgrade the operating system to a version that supports glibc 2.28. +In v8.5 LTS, TiDB ensures multi-level quality standards for various combinations of operating systems and CPU architectures. + ++ For the following combinations of operating systems and CPU architectures, TiDB **provides enterprise-level production quality**, and the product features have been comprehensively and systematically verified: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Operating systemsSupported CPU architectures
Red Hat Enterprise Linux 8.4 or a later 8.x version
  • x86_64
  • ARM 64
Amazon Linux 2
  • x86_64
  • ARM 64
Amazon Linux 2023
  • x86_64
  • ARM 64
Rocky Linux 9.1 or later
  • x86_64
  • ARM 64
Kylin V10 SP1/SP2/SP3 (SP3 is supported starting from v7.5.5)
  • x86_64
  • ARM 64
UnionTech OS (UOS) V20
  • x86_64
  • ARM 64
openEuler 22.03 LTS SP1/SP3
  • x86_64
  • ARM 64
+ + > **Warning:** + > + > - According to [CentOS Linux EOL](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/), the upstream support for CentOS Linux 7 ended on June 30, 2024. + > - Before upgrading TiDB, make sure to check your operating system version. TiDB v8.4.0 DMR and v8.5.0 removed the support of glibc 2.17, and dropped support and testing with CentOS Linux 7. It is recommended to use Rocky Linux 9.1 or a later version. Upgrading a TiDB cluster on CentOS 7 to v8.4.0 or v8.5.0 will cause the risk of cluster unavailability. + > - Starting from v8.5.1, to assist users still using CentOS Linux 7, TiDB resumes the support of glibc 2.17, resumes testing of CentOS Linux 7, and is now compatible with CentOS Linux 7. However, due to the EOL status of CentOS Linux, it is strongly recommended that you review the [official announcements and security guidance](https://www.redhat.com/en/blog/centos-linux-has-reached-its-end-life-eol) for CentOS Linux 7 and migrate to an operating system supported by TiDB for production use, such as Rocky Linux 9.1 or later. + > - According to [Red Hat Enterprise Linux Life Cycle](https://access.redhat.com/support/policy/updates/errata/#Life_Cycle_Dates), the maintenance support for Red Hat Enterprise Linux 7 ended on June 30, 2024. TiDB ends the support for Red Hat Enterprise Linux 7 starting from the 8.4 DMR version. It is recommended to use Rocky Linux 9.1 or a later version. Upgrading a TiDB cluster on Red Hat Enterprise Linux 7 to v8.4.0 or later will cause the cluster to become unavailable. Before upgrading TiDB, make sure to check your operating system version. + ++ For the following combinations of operating systems and CPU architectures, you can compile, build, and deploy TiDB. In addition, you can also use the basic features of OLTP, OLAP, and the data tools. However, because these combinations have not undergone comprehensive and systematic testing, TiDB **does not guarantee enterprise-level production quality**: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Operating systemsSupported CPU architectures
macOS 12 (Monterey) or later
  • x86_64
  • ARM 64
Oracle Enterprise Linux 8 or a laterx86_64
Ubuntu LTS 20.04 or laterx86_64
CentOS Stream 8
  • x86_64
  • ARM 64
Debian 10 (Buster) or laterx86_64
Fedora 38 or laterx86_64
openSUSE Leap later than v15.5 (not including Tumbleweed)x86_64
SUSE Linux Enterprise Server 15x86_64
+ + > **Note:** + > + > - For Oracle Enterprise Linux, TiDB supports the Red Hat Compatible Kernel (RHCK) and does not support the Unbreakable Enterprise Kernel provided by Oracle Enterprise Linux. + > - Support for Ubuntu 16.04 will be removed in future versions of TiDB. Upgrading to Ubuntu 18.04 or later is strongly recommended. + > - CentOS Stream 8 reaches [End of Builds](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/) on May 31, 2024. + ++ If you are using the 32-bit version of an operating system listed in the preceding two tables, TiDB **is not guaranteed** to be compilable, buildable or deployable on the 32-bit operating system and the corresponding CPU architecture, or TiDB does not actively adapt to the 32-bit operating system. + ++ Other operating system versions not mentioned above might work but are not officially supported. ### Libraries required for compiling and running TiDB From 5933b979f2d6410d75d7c19eeb7de6ff9fd2a9ca Mon Sep 17 00:00:00 2001 From: qiancai Date: Wed, 29 Apr 2026 15:04:04 +0800 Subject: [PATCH 5/5] Update hardware-and-software-requirements.md --- hardware-and-software-requirements.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/hardware-and-software-requirements.md b/hardware-and-software-requirements.md index fc94868b9dbd1..e87142b4aaab9 100644 --- a/hardware-and-software-requirements.md +++ b/hardware-and-software-requirements.md @@ -30,7 +30,11 @@ In v8.5 LTS, TiDB ensures multi-level quality standards for various combinations - Red Hat Enterprise Linux 8.4 or a later 8.x version + Red Hat Enterprise Linux 9.4 or a later 9.x version +
  • x86_64
  • ARM 64
+ + + Red Hat Enterprise Linux 8.6 or a later 8.x version
  • x86_64
  • ARM 64
@@ -67,6 +71,10 @@ In v8.5 LTS, TiDB ensures multi-level quality standards for various combinations > - Starting from v8.5.1, to assist users still using CentOS Linux 7, TiDB resumes the support of glibc 2.17, resumes testing of CentOS Linux 7, and is now compatible with CentOS Linux 7. However, due to the EOL status of CentOS Linux, it is strongly recommended that you review the [official announcements and security guidance](https://www.redhat.com/en/blog/centos-linux-has-reached-its-end-life-eol) for CentOS Linux 7 and migrate to an operating system supported by TiDB for production use, such as Rocky Linux 9.1 or later. > - According to [Red Hat Enterprise Linux Life Cycle](https://access.redhat.com/support/policy/updates/errata/#Life_Cycle_Dates), the maintenance support for Red Hat Enterprise Linux 7 ended on June 30, 2024. TiDB ends the support for Red Hat Enterprise Linux 7 starting from the 8.4 DMR version. It is recommended to use Rocky Linux 9.1 or a later version. Upgrading a TiDB cluster on Red Hat Enterprise Linux 7 to v8.4.0 or later will cause the cluster to become unavailable. Before upgrading TiDB, make sure to check your operating system version. + > **Note:** + > + > Support for Red Hat Enterprise Linux 9.x starts from [TiUP](https://github.com/pingcap/tiup/releases) v1.16.5. + + For the following combinations of operating systems and CPU architectures, you can compile, build, and deploy TiDB. In addition, you can also use the basic features of OLTP, OLAP, and the data tools. However, because these combinations have not undergone comprehensive and systematic testing, TiDB **does not guarantee enterprise-level production quality**: