From 808e0254e4f7e73a55674b1f58d76b22c9a6b0e4 Mon Sep 17 00:00:00 2001 From: abraunegg Date: Thu, 21 Feb 2019 17:49:26 +1100 Subject: [PATCH] Update README.md (#384) * Update readme to add details about updating the 'config' file to remove the '.*' from skip_file if present --- README.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index dfd66a32..965a38a9 100644 --- a/README.md +++ b/README.md @@ -234,7 +234,19 @@ docker run $firstRun --restart unless-stopped --name onedrive -v onedrive_conf:/ ### Upgrading from 'skilion' client The 'skilion' version contains a significant number of defect's in how the local sync state is managed. When upgrading from the 'skilion' version to this version, it is advisable to stop any service / onedrive process from running and then remove any `items.sqlite3` file from your configuration directory (`~/.config/onedrive/`) as this will force the creation of a new local cache file. -### Important - curl compatability +Additionally, if you are using a 'config' file within your configuration directory (`~/.config/onedrive/`), please ensure that you update the `skip_file = ` option as per below: + +**Invalid configuration:** +``` +skip_file = "= .*|~*" +``` +**Minimum valid configuration:** +``` +skip_file = "~*" +``` +Do not use a skip_file entry of `.*` as this will prevent correct searching of local changes to process. + +### Important - curl compatibility If your system utilises curl >= 7.62.0 you may need to use `--force-http-1.1` in order for the client to work correctly due to changes in curl to prefer HTTP/2 over HTTP/1.1 by default. ### First run :zap: @@ -396,12 +408,14 @@ Proceed with caution here when changing the default sync dir from ~/OneDrive to The issue here is around how the client stores the sync_dir path in the database. If the config file is missing, or you don't use the `--syncdir` parameter - what will happen is the client will default back to `~/OneDrive` and 'think' that either all your data has been deleted - thus delete the content on OneDrive, or will start downloading all data from OneDrive into the default location. ### skip_file -Example: `skip_file = ".*|~*|Desktop|Documents/OneNote*|Documents/IISExpress|Documents/SQL Server Management Studio|Documents/Visual Studio*|Documents/config.xlaunch|Documents/WindowsPowerShell"` +Example: `skip_file = "~*|Desktop|Documents/OneNote*|Documents/IISExpress|Documents/SQL Server Management Studio|Documents/Visual Studio*|Documents/config.xlaunch|Documents/WindowsPowerShell"` Patterns are case insensitive. `*` and `?` [wildcards characters](https://technet.microsoft.com/en-us/library/bb490639.aspx) are supported. Use `|` to separate multiple patterns. **Note:** after changing `skip_file`, you must perform a full re-synchronization by adding `--resync` to your existing command line - for example: `onedrive --synchronize --resync` +**Note:** Do not use a skip_file entry of `.*` as this will prevent correct searching of local changes to process. + ### skip_symlinks Example: `skip_symlinks = "true"`