Explanation

While unzipping a file on Windows, you might encounter a "file path limit" error due to the system’s inability to handle file paths longer than 260 characters.

Cause

This issue arises because the Windows Operating System imposes a file path limit to around 260 characters in older versions. The file path limit can be exceeded also during file extraction, especially if the file is stored in a deeply nested folder.

Solution

To solve this, you can try:

• Install in a folder that is as close to the root of the drive as possible and uses a small name, e.g. C:\xwiki.
• Install XWiki using the cygwin environment that overcomes this limitation.
• In Windows 10 and 11, you can enable long paths by making both following changes:
  • In the Windows Registry, set EnableLongPaths to 1 under HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem.
  • In the Group Policy Editor by pressing Win + R, typing gpedit.msc, and navigating to Computer Configuration → Administrative Templates → System → File System. Locate Enable Win32 long paths, double-click it, select "Enabled", and click "Apply". A system restart is required for the changes to take effect.
• Use PowerSheel command

  Expand-Archive -Force C:\path\to\XWiki.zip C:\where\to\extract\XWiki

• Alternatively, you can install a third-party utility. See suggestions here.

Related

• Multiple Instances of XWiki in the Same Container.
• XWiki behind a Proxy Server.
• SSL Certificate Error.