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

docs: document new maximum path length error #4437

Merged
merged 1 commit into from Apr 14, 2022
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
32 changes: 32 additions & 0 deletions content/guides/references/error-messages.md
Expand Up @@ -733,6 +733,38 @@ before finally completing. You must add more groups during that time period.
Please review our [parallelization](/guides/guides/parallelization)
documentation to learn more.

<a name='win-max-path-length'></a>

### <Icon name="exclamation-triangle" color="red"></Icon> The Cypress App could not be unzipped. This is most likely because the maximum path length is being exceeded on your system.

When Cypress is installed, it unzips to the designated cache location on your
computer. This error means that Cypress detected that it has exceeded the
maximum path length while unzipping Cypress.

This is common on Windows, where the maximum path length used to be 260
characters.

To fix this error, enable "long paths" on your Windows system:

1. Go to the Start Menu, and right click on PowerShell. Select "Run as
administrator."
2. Run this command:

```powershell
New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" `
-Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
```

3. Restart your computer.

This should get rid of the error. If you are still receiving this error, please
[search for an open issue](https://github.com/cypress-io/cypress/issues) or
[open a new one](https://github.com/cypress-io/cypress/issues/new/choose).

If you do not have Powershell available, you can also make this change via
regedit or gpedit.
[See Microsoft's documentation for details.](https://docs.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation)

## Page Load Errors

### <Icon name="exclamation-triangle" color="red"></Icon> Cypress detected a cross-origin error happened on page load
Expand Down