Windows support for long filenames

Microsoft Windows enforces a Maximum Path Length Limitation, which unfortunately is likely to cause issues in developer usage.

In particular, our set of tools are affected because of how we create isolated Python environments and, for example, we cannot influence or guarantee how the Python libraries that are added as dependencies are named and structured.

So, to ensure the proper functioning of our tools, Windows Long Path Support needs to be enabled in your system.

NOTE: Microsoft Windows comes in many revisions and variants: different versions can impact how the setting is applied, or if this is supported at all.

This guide and our apps work under our system requirements.

How to enable Windows Long Path Support

If you are working with an IT department, you should notify them to make this change into a company-wide setting using group policies, as shown in the step-by-step guide.

Robocorp Lab users

Starting from version 4.7, Robocorp Lab can detect the problem and fix it directly from the app (note that admin permissions are required). lab-support

RCC users

Starting from version 7.0.7, RCC can detect the problem and fix it:

  • To check run rcc configure longpaths
  • To enable run rcc configure longpaths --enable (admin permissions are required)

Robocorp Code users

Support to fix the issue automatically in the VS Code extension is coming soon. For now, please follow the step-by-step guide.

Robocorp App users

Support to fix the issue automatically in Robocorp App is coming soon. For now, please follow the step-by-step guide.

Step-by-step guide

  1. Open the Local Group Policy Editor application: - Start --> type gpedit.msc --> Enter: gpedit
  2. Navigate to Computer Configuration > Administrative Templates > System > Filesystem. On the right, find the "Enable win32 long paths" item and double-click it. gpedit-target
  3. Change the setting to Enabledgpedit-enabled
  4. Exit the Local Group Policy Editor and restart your computer (or sign out and back in) to allow the changes to finish.

If the problem persists after those steps, try the following:

  1. Open the Registry Editor application: - Start --> type regedit.msc and press Enter: regedit
  2. Navigate to HKEY-LOCAL-MACHINE > SYSTEM > CurrentControlSet > Control > FileSystem. On the right, find the LongPathsEnabled item and double-click it. regedit
  3. Change the Value data: to 1. regedit
  4. Exit the Registry Editor.