From 2d54f3e4d137b221366032b7d99863b276043075 Mon Sep 17 00:00:00 2001 From: abraunegg Date: Sat, 2 Mar 2019 10:51:51 +1100 Subject: [PATCH] Update README.md (#396) * Add details on how to change the authorisation of the client if the OneDrive account password is changed --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index e92eb82d..49d22144 100644 --- a/README.md +++ b/README.md @@ -383,6 +383,18 @@ If you want to just delete the application key, but keep the items database: rm -f ~/.config/onedrive/refresh_token ``` +### Handling a OneDrive account password change +If you change your OneDrive account password, the client will no longer be authorised to sync, and will generate the following error: +```text +ERROR: OneDrive returned a 'HTTP 401 Unauthorized' - Cannot Initialize Sync Engine +``` +To re-authorise the client, follow the steps below: +1. If running the client as a service (init.d or systemd), stop the service +2. Run the command `onedrive --logout`. This will clean up the previous authorisation, and will prompt you to re-authorise as per initial configuration. +3. Restart the client if running as a service or perform a manual sync + +The application will now sync with OneDrive with the new credentials. + ## Additional Configuration Additional configuration is optional. If you want to change the defaults, you can copy and edit the included config file into your `~/.config/onedrive` directory: