diff --git a/docs/faq/README.md b/docs/faq/README.md index bca46bbad1e5689b4e14db46de317389757598fa..ee8d6a963ec29c5ff9d1bb5b7384f31657cf50fe 100644 --- a/docs/faq/README.md +++ b/docs/faq/README.md @@ -12,3 +12,21 @@ Is it possible to run GitLab Runner in debug/verbose mode. Do it from terminal: ``` gitlab-runner --debug run ``` + +## 3. I get a PathTooLongException during my builds on Windows + +This is caused by tools like `npm` which will sometimes generate directory structures +with paths more than 260 characters in length. There are two possible fixes you can +adopt to solve the problem. + +### a) Use Git with core.longpaths enabled + +You can avoid the problem by using Git to clean your directory structure, first run +`git config --system core.longpaths true` from the command line and then set your +project to use *git fetch* from the GitLab CI project settings page. + +### b) Use NTFSSecurity tools for PowerShell + +The [NTFSSecurity](https://ntfssecurity.codeplex.com/) PowerShell module provides +a *Remove-Item2* method which supports long paths. The Gitlab CI Multi Runner will +detect it if it is available and automatically make use of it. \ No newline at end of file