Troubleshooting – "Unknown error"

The error message "Unknown error" appears for a number of errors which CODESYS cannot resolve by itself. However, there are ways for the user to correct some of these errors.

In the message dialog with the error message, click the Details button to get more information about the error.

See below for instructions on how to handle the respective error:

`Path too long`

This error message can appear if the file paths of the Git project in the file system are too long. To resolve the problem, you need to enable the Long paths option for Git. There are two possible solutions for this:

Enable the option in the project via Git Config:
In the open project, click the Git → Git Config command. In the configuration dialog, enable the Long paths option. Click OK to exit the dialog. Close the project and open it again.
Enable the option in the .gitconfig file of the user:
Open the file C:\Benutzer\<user name>\.gitconfig (example: C:\Users\m.muster\.gitconfig). Edit the file so that there is an entry longpaths = true in the core area. Then close the project and open it again.
```
[core]    
 longpaths = true
```

Conflict prevents checkout

This error can occur with Git operations that perform a merge (git merge/gitpull). There are probably modified files in the repository which are not part of the CODESYS project.

Open the Status & Staging view. Check whether "external" files are listed under Unstaged Changes. This means the files which cannot be found as objects in the project in the Devices or POUs views.

You can also check whether a file is an external file as follows: Double-click the file entry in the Object column of the Status & Mark view. If the error message External objects are not supported in diff view appears instead of the comparison view, then an external object exists.