From d48bb34036d2502a8f41f2e11f1128c98da386d3 Mon Sep 17 00:00:00 2001 From: Kendon Bell Date: Tue, 28 Mar 2023 08:41:57 +1300 Subject: [PATCH] Add warning regarding SharePoint Library use (#2354) * Add suggested warning * Update PR wording --------- Co-authored-by: abraunegg --- docs/SharePoint-Shared-Libraries.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/SharePoint-Shared-Libraries.md b/docs/SharePoint-Shared-Libraries.md index c549c64a..d1714d4e 100644 --- a/docs/SharePoint-Shared-Libraries.md +++ b/docs/SharePoint-Shared-Libraries.md @@ -1,4 +1,19 @@ # How to configure OneDrive SharePoint Shared Library sync +**WARNING:** Several users have reported files being overwritten causing data loss as a result of using this client with SharePoint Libraries when running as a systemd service. + +When this has been investigated, the following has been noted as potential root causes: +* File indexing application such as Baloo File Indexer or Tracker3 constantly indexing your OneDrive data +* The use of WPS Office and how it 'saves' files by deleting the existing item and replaces it with the saved data + +Additionally there could be a yet unknown bug with the client, however all debugging and data provided previously shows that an 'external' process to the 'onedrive' application modifies the files triggering the undesirable upload to occur. + +**Possible Preventative Actions:** +* Disable all File Indexing for your SharePoint Library data. It is out of scope to detail on how you should do this. +* Disable using a systemd service for syncing your SharePoint Library data. +* Do not use WPS Office to edit your documents. Use OpenOffice or LibreOffice as these do not exhibit the same 'delete to save' action that WPS Office has. + +Additionally, please use caution when using this client with SharePoint. + ## Application Version Before reading this document, please ensure you are running application version [![Version](https://img.shields.io/github/v/release/abraunegg/onedrive)](https://github.com/abraunegg/onedrive/releases) or greater. Use `onedrive --version` to determine what application version you are using and upgrade your client if required.