Skip to content

Commit

Permalink
docs: document new maximum path length error
Browse files Browse the repository at this point in the history
  • Loading branch information
flotwig committed Apr 12, 2022
1 parent 624abab commit 2c68020
Showing 1 changed file with 32 additions and 0 deletions.
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

0 comments on commit 2c68020

Please sign in to comment.