From a1d901c690c86a5d97c446f38832ad574ce2afdf Mon Sep 17 00:00:00 2001 From: AtofStryker Date: Wed, 24 Jul 2024 17:54:44 -0400 Subject: [PATCH 1/4] update documentation to display required minimum version of glibc and retroactively supported operating systems --- docs/guides/getting-started/installing-cypress.mdx | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/guides/getting-started/installing-cypress.mdx b/docs/guides/getting-started/installing-cypress.mdx index 2a491e98a6..b9027168d3 100644 --- a/docs/guides/getting-started/installing-cypress.mdx +++ b/docs/guides/getting-started/installing-cypress.mdx @@ -163,10 +163,12 @@ need prebuilt. Cypress is a desktop application that is installed on your computer. The desktop application supports these operating systems: -- **macOS** 10.15 and above _(Intel or Apple Silicon 64-bit (x64 or arm64))_ +- **macOS** 10.15 and above _(Intel or Apple Silicon 64-bit (x64 or arm64))_. - **Linux** Ubuntu 20.04 and above, Fedora 38 and above, and Debian 10 and above _(x64 or arm64)_ (see [Linux Prerequisites](#Linux-Prerequisites) down - below) -- **Windows** 10 and above _(64-bit only)_ + below). + - Cypress requires a minimum of [`glibc`](https://www.gnu.org/software/libc/) version `2.17` to run. We recommend a [`glibc`](https://www.gnu.org/software/libc/) version of `2.28` or later. + - Though Cypress does not actively support CentOS 7, RHEL 7, or Amazon Linux 2, the Cypress application binary should be able to run on these platforms as the [`glibc`](https://www.gnu.org/software/libc/) version meets the minimum requirement. +- **Windows** 10 and above _(64-bit only)_. ### Node.js From e69d00a687e4ca3863f7830f9a5a1f16fb91e3d7 Mon Sep 17 00:00:00 2001 From: AtofStryker Date: Thu, 25 Jul 2024 15:50:18 -0400 Subject: [PATCH 2/4] update documentation to apply suggestions --- docs/guides/getting-started/installing-cypress.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/guides/getting-started/installing-cypress.mdx b/docs/guides/getting-started/installing-cypress.mdx index b9027168d3..ac6151d909 100644 --- a/docs/guides/getting-started/installing-cypress.mdx +++ b/docs/guides/getting-started/installing-cypress.mdx @@ -166,8 +166,8 @@ application supports these operating systems: - **macOS** 10.15 and above _(Intel or Apple Silicon 64-bit (x64 or arm64))_. - **Linux** Ubuntu 20.04 and above, Fedora 38 and above, and Debian 10 and above _(x64 or arm64)_ (see [Linux Prerequisites](#Linux-Prerequisites) down below). - - Cypress requires a minimum of [`glibc`](https://www.gnu.org/software/libc/) version `2.17` to run. We recommend a [`glibc`](https://www.gnu.org/software/libc/) version of `2.28` or later. - - Though Cypress does not actively support CentOS 7, RHEL 7, or Amazon Linux 2, the Cypress application binary should be able to run on these platforms as the [`glibc`](https://www.gnu.org/software/libc/) version meets the minimum requirement. + - Cypress deprecated the use of Node.js `16.x` in Cypress [`13.0.0`](/guides/references/changelog#13-0-0). We recommend that users update to at least Node.js `18.x`. + For related reasons, Cypress deprecates the use of Linux operating systems with library [`glibc`](https://www.gnu.org/software/libc/) versions `2.17` - `2.27`. The Linux CLI command `ldd --version` displays your glibc version. - **Windows** 10 and above _(64-bit only)_. ### Node.js From 1e735edd163538a4d58c98b7b067870deb5e7c6d Mon Sep 17 00:00:00 2001 From: AtofStryker Date: Fri, 26 Jul 2024 10:20:05 -0400 Subject: [PATCH 3/4] add min glibc version in linux prereqs --- docs/guides/getting-started/installing-cypress.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/getting-started/installing-cypress.mdx b/docs/guides/getting-started/installing-cypress.mdx index ac6151d909..f83bd5ecaa 100644 --- a/docs/guides/getting-started/installing-cypress.mdx +++ b/docs/guides/getting-started/installing-cypress.mdx @@ -231,7 +231,7 @@ requirements: ### Linux Prerequisites If you're using Linux, you'll want to have the required dependencies installed -on your system. Depending on your system defaults, these dependencies may already be installed. +on your system. Cypress on Linux requires a minimum [`glibc`](https://www.gnu.org/software/libc/) version of `2.17`. Depending on your system defaults, these dependencies may already be installed. If not, run the command line for your operating system listed below. See below under [Docker Prerequisites](#Docker-Prerequisites) for information on [Cypress Docker images](https://github.com/cypress-io/cypress-docker-images). These already include the necessary dependencies. From 091fe973d6866e3041db8930edc3b3f5f6ed297a Mon Sep 17 00:00:00 2001 From: AtofStryker Date: Fri, 26 Jul 2024 10:39:48 -0400 Subject: [PATCH 4/4] attempt to reword glibc min requirement --- docs/guides/getting-started/installing-cypress.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/guides/getting-started/installing-cypress.mdx b/docs/guides/getting-started/installing-cypress.mdx index f83bd5ecaa..900b3fd44c 100644 --- a/docs/guides/getting-started/installing-cypress.mdx +++ b/docs/guides/getting-started/installing-cypress.mdx @@ -231,10 +231,12 @@ requirements: ### Linux Prerequisites If you're using Linux, you'll want to have the required dependencies installed -on your system. Cypress on Linux requires a minimum [`glibc`](https://www.gnu.org/software/libc/) version of `2.17`. Depending on your system defaults, these dependencies may already be installed. +on your system. Depending on your system defaults, these dependencies may already be installed. If not, run the command line for your operating system listed below. See below under [Docker Prerequisites](#Docker-Prerequisites) for information on [Cypress Docker images](https://github.com/cypress-io/cypress-docker-images). These already include the necessary dependencies. +It is worth noting that Cypress on Linux requires a minimum [`glibc`](https://www.gnu.org/software/libc/) version of `2.17`. This version is fixed as `glibc` is shipped with your operating system and cannot be changed. + #### Ubuntu/Debian ```shell