Skip to content

docs: minimum linux requirements for electron 36 #6219

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Jul 10, 2025
Merged

docs: minimum linux requirements for electron 36 #6219

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
a05de30
minimum linux requirements for electron 36
cacieprins Jul 7, 2025
e98ddcb
fix deb 10 ref for cy 14
cacieprins Jul 7, 2025
e788931
rm tables, make concise
cacieprins Jul 7, 2025
003d5a9
Update docs/app/get-started/install-cypress.mdx
cacieprins Jul 7, 2025
806677b
Update docs/app/references/migration-guide.mdx
cacieprins Jul 7, 2025
42d36e0
Update docs/app/references/migration-guide.mdx
jennifer-shehane Jul 8, 2025
9579880
Merge branch 'release/15.0.0' into glibc-electron-36
jennifer-shehane Jul 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 2 additions & 3 deletions docs/app/get-started/install-cypress.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ Cypress supports running under these operating systems:

Cypress requires [Node.js](https://nodejs.org/) in order to install. We support the versions listed below:

- **Node.js** 20.x, 22.x, 24.x and above
- **Node.js** 18.x, 20.x, 22.x and above

Cypress generally aligns with
[Node's release schedule](https://github.com/nodejs/Release).
Expand Down Expand Up @@ -260,5 +260,4 @@ It is recommended to have `unzip` installed. This avoids the Cypress binary inst

## Next Steps

[Open the app](/app/get-started/open-the-app) and take it for a test
drive!
[Open the app](/app/get-started/open-the-app) and take it for a test drive!
8 changes: 8 additions & 0 deletions docs/app/references/migration-guide.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,14 @@ Cypress requires [Node.js](https://nodejs.org/en) in order to install the Cypres
Node.js versions 18 and 23 are no longer supported.
[See Node's release schedule](https://github.com/nodejs/Release).

### Unsupported Linux Distributions

Prebuilt binaries for Linux are no longer compatible with Linux distributions based on glibc `<2.31`.
This support is in line with Node.js's support for Linux in 20+.

If you're using a Linux distribution based on glibc `<2.31`, for example, Ubuntu 18.04, RHEL 8, CentOS 8, AlmaLinux 8, Rocky Linux 8, you'll need to
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Although it is true that Ubuntu 18 won't work with Cypress 15, it was already removed in 2023 - see #5515 because it didn't meet the previous criteria for minimum glibc 2.28. So it could probably be removed from the list here. That is to say it is not compatible with Cypress 14 either, so it's nothing new for Cypress 15.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

just for background information - attempting to install Cypress 14 on Ubuntu 18.04 definitely doesn't work:

$ n 16
     copying : node/16.20.2
   installed : v16.20.2 (with npm 8.19.4)
$ yarn add cypress
yarn add v1.22.22
info No lockfile found.
[1/4] Resolving packages...
[2/4] Fetching packages...
error [email protected]: The engine "node" is incompatible with this module. Expected version "^18.0.0 || ^20.0.0 || >=22.0.0". Got "16.20.2"
error Found incompatible module.
info Visit https://yarnpkg.com/en/docs/cli/add for documentation about this command.
$ n 18
  installing : node-v18.20.8
       mkdir : /home/mike/n/n/versions/node/18.20.8
       fetch : https://nodejs.org/dist/v18.20.8/node-v18.20.8-linux-x64.tar.xz
     copying : node/18.20.8
node: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.28' not found (required by node)
/home/mike/n/bin/node: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.28' not found (required by /home/mike/n/bin/node)
   installed :  (with npm )

update your system to a newer version to install Cypress 15+.

### Webpack `4` is no longer supported

Cypress is no longer supporting Webpack `4` as it is no longer maintained by the core Webpack team and Webpack `5` has been available since Q4 2020. This includes Webpack `4` support for:
Expand Down