Troubleshooting

---

We strongly recommend keeping both your desktop app and operating system up to date by installing the latest release versions, as well as ensuring your operating system is on the latest patch or version to avoid potential issues.

If you receive a Windows Error message referencing "0x80070643", this is a Microsoft error related to your .NET Framework installation.

You can resolve this issue by simply rebooting your system, and then try the install again. If you still receive the same error after rebooting, download the .NET framework Repair Tool from Microsoft and run it.

One other possible cause of this error is antivirus software. When we've seen this in the past, it has been triggered by Avast antivirus software. Users have found that they can temporarily turn off Avast, complete the install, then turn Avast back on.

First, make sure that your user has the proper permissions to use the Desktop app. This is enabled by default for most sites (though Site Administrators can turn this off).

If you're unable to log in, you may need to contact your Files.com site administrator, and request that they enable access in your user account's settings for protocol access.

The Files.com desktop app exclusively uses port 443 (HTTPS) for outbound communication, and should operate behind most corporate firewalls.

The Desktop app requires that your default web browser and the desktop app share the same IP address for a successful connection. The connection will fail if the web browser is using any kind of proxy or VPN. If you encounter any login authentication errors or connection issues, please contact your system administrator to disable any proxies or VPNs in your web browser that may be causing the problem.

If your files are not uploading to Files.com when you are online without any network issues, it is possible that the user doesn't have write permissions on that corresponding folder. You may see an error message such as "The operation can't be completed because an unexpected error occurred (error code 0)" when you are trying to create files or folders if the user doesn't have enough permissions on that folder.

On Windows, the desktop application logs are located at C:\Users\ [USERNAME]\AppData\Roaming\com.files.desktop\. On Mac, the logs are located at ~/Library/Logs/Files.com/.

You can troubleshoot issues with the Files.com desktop app, such as upload/download issues, authentication issues or any unexpected behavior by enabling the debug logs. However, it's important to note that enabling debug logs should only be done when absolutely necessary for troubleshooting. Debug logs won't be created automatically; you'll need to activate debug logging by selecting the Enable debug log option from Files.com Pinwheel icon -> Preferences -> Help -> Log. You can view the logs location by clicking the Show in Finder or Show in Explorer button in the Log section.

Our running log file is named files.com.log. Log files are rotated at 100 MB intervals, and once the running log file reaches 100 MB, it is archived. We maintain a maximum of five archived files alongside the running log file, all stored within the same folder. This practice prevents the running log file from becoming excessively large and so it is important to collect the debug logs as soon as the actual issue is reproduced.

If you are sending the debug log files to our support team, we recommend zipping the entire folder called com.files.desktop located under C:\Users\ [USERNAME]\AppData\Roaming\ on Windows (or Files.com folder under ~/Library/Logs/ on macOS) and then sending the zipped file. If you encounter issues accessing files through a third-party application (such as Adobe, MS-Office, AutoCAD, etc.), we recommend collecting the relevant logs, screenshots, and version information from the respective third-party application and submit them, along with the actual debug logs from the desktop application, to our support team.

Remember to disable debug logging once the issue has been analyzed or resolved, as generating these logs can impose additional load on the desktop app and may potentially affect the performance of the app. To disable the debug logs, go to Files.com Pinwheel icon -> Preferences -> Help -> Log and unselect the Enable debug log option.

Invalid file and folder names are usually caused by limitations of the underlying operating system being used. Operating systems such as Windows, Linux, and Mac each have their own specific restrictions for which characters can be used to name a file or folder. Additionally, 3rd party service providers can overlay their own restrictions. It is not practical for Files.com to maintain a database of all restrictions that may apply.

If you see issues with invalid file or folder names, we recommend you modify those names to remove the restricted characters.

Some examples of restricted characters are:

• < (less than)
• > (greater than)
• : (colon)
• " (double quote)
• / (forward slash)
• \ (backslash)
• | (vertical bar or pipe)
• ? (question mark)
• * (asterisk)
• # (hash or pound)
• % (percent)
• & (ampersand)
• @ (at)
• ^ (caret)
• $ (dollar)
• ! (exclamation)

Invalid folder names, such as . and .., might be allowed by some object storage solutions but will cause incompatibility with Files.com. Rename or remove these invalid folder names to restore compatibility.

Some systems may also restrict the length of the file or folder name. Common length limits include 160 characters and 255 characters.

Bear in mind that some systems calculate the total length as being either just the file or folder name, including any extension or the sum of the whole folder path + file name + extension + temporary suffix.

To resolve this issue, shorten the name of files and folders so that they are below the length limits of the system.

On the Files.com side, the path limit is 550 characters for the sum of the full path, including folder names.