-
-
Notifications
You must be signed in to change notification settings - Fork 871
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* Release files for 2.4.8
- Loading branch information
Showing
14 changed files
with
216 additions
and
59 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -55,7 +55,7 @@ endif | |
| system_unit_files = contrib/systemd/[email protected] | ||
| user_unit_files = contrib/systemd/onedrive.service | ||
|
|
||
| DOCFILES = README.md config LICENSE CHANGELOG.md docs/Docker.md docs/INSTALL.md docs/Office365.md docs/USAGE.md docs/BusinessSharedFolders.md | ||
| DOCFILES = README.md config LICENSE CHANGELOG.md docs/Docker.md docs/INSTALL.md docs/Office365.md docs/USAGE.md docs/BusinessSharedFolders.md docs/advanced-usage.md | ||
|
|
||
| ifneq ("$(wildcard /etc/redhat-release)","") | ||
| RHEL = $(shell cat /etc/redhat-release | grep -E "(Red Hat Enterprise Linux Server|CentOS)" | wc -l) | ||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,23 +1,46 @@ | ||
| # Show how to access a Sharepoint group drive in Office 365 business or education | ||
| ## Obtaining the Sharepoint Site Details | ||
| # How to configure OneDrive SharePoint Shared Library sync | ||
| Syncing a OneDrive SharePoint library requires additional configuration for your 'onedrive' client: | ||
| 1. Login to OneDrive and under 'Shared Libraries' obtain the shared library name | ||
| 2. Query that shared library name using the client to obtain the required configuration details | ||
| 3. Configure the client's config file with the required 'drive_id' | ||
| 4. Test the configuration using '--dry-run' | ||
| 5. Sync the SharePoint Library as required | ||
|
|
||
| ## Listing available OneDrive SharePoint Libraries | ||
| 1. Login to the OneDrive web interface and determine which shared library you wish to configure the client for: | ||
|  | ||
|
|
||
| ## Query that shared library name using the client to obtain the required configuration details | ||
| 2. Run the following command using the 'onedrive' client | ||
| ```text | ||
| onedrive --get-O365-drive-id '<your library name>' | ||
| ``` | ||
| 3. This will return the following: | ||
| ```text | ||
| Configuration file successfully loaded | ||
| Configuring Global Azure AD Endpoints | ||
| Initializing the Synchronization Engine ... | ||
| Office 365 Library Name Query: <your library name> | ||
| SiteName: <your library name> | ||
| drive_id: b!6H_y8B...xU5 | ||
| URL: <your site URL> | ||
| ``` | ||
|
|
||
| ## Configuring the onedrive client | ||
| Once you have obtained the 'drive_id' above, add to your 'onedrive' configuration file (`~/.config/onedrive/config`) the following: | ||
| ## Configure the client's config file with the required 'drive_id' | ||
| 4. Once you have obtained the 'drive_id' above, add to your 'onedrive' configuration file (`~/.config/onedrive/config`) the following: | ||
| ```text | ||
| drive_id = "insert the drive id from above here" | ||
| drive_id = "insert the drive_id value from above here" | ||
| ``` | ||
| The OneDrive client will now be configured to sync this SharePoint shared library to your local system. | ||
|
|
||
| **Note:** After changing `drive_id`, you must perform a full re-synchronization by adding `--resync` to your existing command line. | ||
|
|
||
| ## Test the configuration using '--dry-run' | ||
| 5. Test your new configuration using the `--dry-run` option to validate the the new configuration | ||
|
|
||
| ## Sync the SharePoint Library as required | ||
| 6. Sync the SharePoint Library to your system with either `--synchronize` or `--monitor` operations | ||
|
|
||
|
|
||
| The OneDrive client will now sync this SharePoint shared library to your local system. | ||
| # How to configure multiple OneDrive SharePoint Shared Library sync | ||
| Refer to [./advanced-usage.md](advanced-usage.md) for configuration assistance. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,139 @@ | ||
| # Advanced Configuration of the OneDrive Free Client | ||
| This document covers the following scenarios: | ||
| * Configuring the client to use mutlitple OneDrive accounts / configurations | ||
| * Configuring the client for use in dual-boot (Windows / Linux) situations | ||
|
|
||
| ## Configuring the client to use mutlitple OneDrive accounts / configurations | ||
| Essentially, each OneDrive account or SharePoint Shared Library which you require to be synced needs to have it's own and unique configuration, local sync directory and service files. To do this, the following steps are needed: | ||
| 1. Create a unique configuration folder for each onedrive client configuration that you need | ||
| 2. Copy to this folder a copy of the default configuration file | ||
| 3. Update the default configuration file as required, changing the required minimum config options and any additional options as needed to support your multi-account configuration | ||
| 4. Authenticate the client using the new configuration directory | ||
| 5. Test the configuration using '--display-config' and '--dry-run' | ||
| 6. Sync the OneDrive account data as required using `--synchronize` or `--monitor` | ||
| 7. Configure a unique systemd service file for this account configuration | ||
|
|
||
| ### 1. Create a unique configuration folder for each onedrive client configuration that you need | ||
| Make the configuration folder as required for this new configuration, for example: | ||
| ```text | ||
| mkdir ~/.config/my-new-config | ||
| ``` | ||
|
|
||
| ### 2. Copy to this folder a copy of the default configuration file | ||
| Copy to this folder a copy of the default configuration file by downloading this file from GitHub and saving this file in the directory created above: | ||
| ```text | ||
| wget https://raw.githubusercontent.com/abraunegg/onedrive/master/config -O ~/.config/my-new-config/config | ||
| ``` | ||
|
|
||
| ### 3. Update the default configuration file | ||
| The following config options *must* be updated to ensure that individual account data is not cross populated with other OneDrive accounts or other configurations: | ||
| * sync_dir | ||
|
|
||
| Other options that may require to be updated, depending on the OneDrive account that is being configured: | ||
| * drive_id | ||
| * application_id | ||
| * sync_business_shared_folders | ||
| * skip_dir | ||
| * skip_file | ||
| * Creation of a 'sync_list' file if required | ||
| * Creation of a 'business_shared_folders' file if required | ||
|
|
||
| ### 4. Authenticate the client | ||
| Authenticate the client using the specific configuration file: | ||
| ```text | ||
| onedrive --confdir="~/.config/my-new-config" | ||
| ``` | ||
| You will be asked to open a specific URL by using your web browser where you will have to login into your Microsoft Account and give the application the permission to access your files. After giving permission to the application, you will be redirected to a blank page. Copy the URI of the blank page into the application. | ||
| ```text | ||
| [user@hostname ~]$ onedrive --confdir="~/.config/my-new-config" | ||
| Configuration file successfully loaded | ||
| Configuring Global Azure AD Endpoints | ||
| Authorize this app visiting: | ||
| https://..... | ||
| Enter the response uri: | ||
| ``` | ||
|
|
||
| ### 5. Display and Test the configuration | ||
| Test the configuration using '--display-config' and '--dry-run'. By doing so, this allows you to test any configuration that you have currently made, enabling you to fix this configuration before using the configuration. | ||
|
|
||
| #### Display the configuration | ||
| ```text | ||
| onedrive --confdir="~/.config/my-new-config --display-config" | ||
| ``` | ||
|
|
||
| #### Test the configuration by performing a dry-run | ||
| ```text | ||
| onedrive --confdir="~/.config/my-new-config" --synchronize --verbose --dry-run | ||
| ``` | ||
|
|
||
| If both of these operate as per your expectation, the configuration of this client setup is complete and validated. If not, amend your configuration as required. | ||
|
|
||
| ### 6. Sync the OneDrive account data as required | ||
| Sync the data for the new account configuration as required: | ||
| ```text | ||
| onedrive --confdir="~/.config/my-new-config" --synchronize --verbose | ||
| ``` | ||
| or | ||
| ```text | ||
| onedrive --confdir="~/.config/my-new-config" --monitor --verbose | ||
| ``` | ||
|
|
||
| * `--synchronize` does a one-time sync | ||
| * `--monitor` keeps the application running and monitoring for changes both local and remote | ||
|
|
||
| ### 7. Automatic syncing of new OneDrive configuration | ||
| In order to automatically start syncing your OneDrive accounts, you will need to create a service file for each account. From the applicable 'systemd folder' where the applicable systemd service file exists: | ||
| * RHEL / CentOS: `/usr/lib/systemd/system` | ||
| * Others: `/usr/lib/systemd/user` and `/lib/systemd/system` | ||
|
|
||
| **Note:** The `onedrive.service` runs the service as the 'root' user, whereas the `[email protected]` runs the service as your user account. | ||
|
|
||
| Copy the required service file to a new name: | ||
| ```text | ||
| cp onedrive.service onedrive-my-new-config.service | ||
| ``` | ||
| or | ||
| ```text | ||
| cp [email protected] [email protected] | ||
| ``` | ||
|
|
||
| Edit the line beginning with `ExecStart` so that the confdir mirrors the one you used above: | ||
| ```text | ||
| ExecStart=/usr/local/bin/onedrive --monitor --confdir="/full/path/to/config/dir" | ||
| ``` | ||
|
|
||
| Example: | ||
| ```text | ||
| ExecStart=/usr/local/bin/onedrive --monitor --confdir="/home/myusername/.config/my-new-config" | ||
| ``` | ||
|
|
||
| Then you can safely run these commands: | ||
| ```text | ||
| systemctl --user enable onedrive-my-new-config | ||
| systemctl --user start onedrive-my-new-config | ||
| ``` | ||
| or | ||
| ```text | ||
| systemctl --user enable [email protected] | ||
| systemctl --user start [email protected] | ||
| ``` | ||
|
|
||
| Repeat these steps for each OneDrive new account that you wish to use. | ||
|
|
||
| ## Configuring the client for use in dual-boot (Windows / Linux) situations | ||
| When dual booting Windows and Linux, depending on the Windows OneDrive account configuration, the 'Files On-Demand' option may be enabled when running OneDrive within your Windows environment. | ||
|
|
||
| When this option is enabled in Windows, if you are sharing this location between your Windows and Linux systems, all files will be a 0 byte link, and cannot be used under Linux. | ||
|
|
||
| To fix the problem of windows turning all files (that should be kept offline) into links, you have to uncheck a specific option in the onedrive settings window. The option in question is `Save space and download files as you use them`. | ||
|
|
||
| To find this setting, open the onedrive pop-up window from the taskbar, click "Help & Settings" > "Settings". This opens a new window. Go to the tab "Settings" and look for the section "Files On-Demand". | ||
|
|
||
| After unchecking the option and clicking "OK", the Windows OneDrive client should restart itself and start actually downloading your files so they will truely be available on your disk when offline. These files will then be fully accessible under Linux and the Linux OneDrive client. | ||
|
|
||
| | OneDrive Personal | Onedrive Business<br>SharePoint | | ||
| |---|---| | ||
| |  |  | |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Oops, something went wrong.