Skip to content
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.

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

WSL/WSL2 installation documented although unsupported #5489

Closed
MikeMcC399 opened this issue Sep 22, 2023 · 2 comments · Fixed by #5756
Closed

WSL/WSL2 installation documented although unsupported #5489

MikeMcC399 opened this issue Sep 22, 2023 · 2 comments · Fixed by #5756

Comments

@MikeMcC399
Copy link
Contributor

Subject

References > Advanced Installation > Windows Subsystem for Linux

Description

The section Windows Subsystem for Linux describes how to install WSL to display the Cypress UI.

Users who report problems to the Cypress issues list under WSL or WSL2 are however being told that this configuration is not supported (for instance cypress-io/cypress#27858 (comment)).

Suggestion

@MikeMcC399
Copy link
Contributor Author

Depending on the reasons for not supporting WSL perhaps something along the lines of the following suggestions could be published?

Option 1 - WSL does not work correctly

We advise against the use of Cypress with Microsoft Windows Subsystem for Linux due to known issues in this environment and for this reason it is not supported.

Then remove all other WSL technical content.

Option 2 - WSL works but is not tested

Users have reported success with Cypress running under the Windows Subsystem for Linux (WSL) virtual environment however we do not test releases of Cypress for compatibility with WSL and for this reason we do not provide support for it. Other Cypress users in the Discord Technical Community may be able to help if you encounter any issues with Cypress running under WSL. If you believe you have found a bug in Cypress operating in a WSL environment and you wish to report it, please ensure that the issue is reproducible without using WSL on one of the Cypress supported operating systems.

For your convenience here are links to Microsoft documentation:

The combination of WSL2 with WSLg as X11 server is currently the latest and recommended WSL environment for Cypress based on user feedback.

Replacing all other WSL technical content by the above links to Microsoft documentation.

@MikeMcC399
Copy link
Contributor Author

Cypress.io does not specifically support the use of Cypress under Windows Subsystem for Linux (WSL). If you want to report an issue, please ensure that you can reproduce it without using WSL on one of the Cypress supported operating systems.

This needs to be confirmed by the Cypress.io team.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

1 participant