abraunegg-onedrive/readme.md

OneDrive Client for Linux

Introducing a free Microsoft OneDrive Client that seamlessly supports OneDrive Personal, OneDrive for Business, OneDrive for Office365, and SharePoint Libraries.

This robust and highly customisable client is compatible with all major Linux distributions and FreeBSD, and can also be deployed as a container using Docker or Podman. It offers both one-way and two-way synchronisation capabilities while ensuring a secure connection to Microsoft OneDrive services.

Originally derived as a 'fork' from the skilion client, it's worth noting that the developer of the original client has explicitly stated they have no intention of maintaining or supporting their work (reference).

This client represents a 100% re-imagining of the original work, addressing numerous notable bugs and issues while incorporating a significant array of new features. This client has been under active development since mid-2018.

Features

• State caching
• Real-Time local file monitoring with inotify
• Real-Time syncing of remote updates via webhooks
• File upload / download validation to ensure data integrity
• Resumable uploads
• Support OneDrive for Business (part of Office 365)
• Shared Folder support for OneDrive Personal and OneDrive Business accounts
• SharePoint / Office365 Shared Libraries
• Desktop notifications via libnotify
• Dry-run capability to test configuration changes
• Prevent major OneDrive accidental data deletion after configuration change
• Support for National cloud deployments (Microsoft Cloud for US Government, Microsoft Cloud Germany, Azure and Office 365 operated by 21Vianet in China)
• Supports single & multi-tenanted applications
• Supports rate limiting of traffic
• Supports multi-threaded uploads and downloads

What's missing

• Ability to encrypt/decrypt files on-the-fly when uploading/downloading files from OneDrive
• Support for Windows 'On-Demand' functionality so file is only downloaded when accessed locally

External Enhancements

• A GUI for configuration management: OneDrive Client for Linux GUI
• Colorful log output terminal modification: OneDrive Client for Linux Colorful log Output
• System Tray Icon: OneDrive Client for Linux System Tray Icon

Frequently Asked Questions

Refer to Frequently Asked Questions

Have a question

If you have a question or need something clarified, please raise a new disscussion post here

Reporting an Issue or Bug

If you encounter any bugs you can report them here on Github. Before filing an issue be sure to:

1. Check the version of the application you are using onedrive --version and ensure that you are running either the latest release or built from master.
2. Fill in a new bug report using the issue template
3. Generate a debug log for support using the following process
   • If you are in any way concerned regarding the sensitivity of the data contained with in the verbose debug log file, create a new OneDrive account, configure the client to use that, use dummy data to simulate your environment and then replicate your original issue
   • If you are still concerned, provide an NDA or confidentiality document to sign
4. Upload the debug log to pastebin or archive and email to support@mynas.com.au
   • If you are concerned regarding the sensitivity of your debug data, encrypt + password protect the archive file and provide the decryption password via an out-of-band (OOB) mechanism. Email support@mynas.com.au for an OOB method for the password to be sent.
   • If you are still concerned, provide an NDA or confidentiality document to sign

Known issues

Refer to docs/known-issues.md

Documentation and Configuration Assistance

Installing from Distribution Packages or Building the OneDrive Client for Linux from source

Refer to docs/install.md

Configuration and Usage

Refer to docs/usage.md

Configure OneDrive Business Shared Folders

Refer to docs/business-shared-folders.md

Configure SharePoint / Office 365 Shared Libraries (Business or Education)

Refer to docs/sharepoint-libraries.md

Configure National Cloud support

Refer to docs/national-cloud-deployments.md

Docker support

Refer to docs/docker.md

Podman support

Refer to docs/podman.md