2020-04-18 22:24:35 +02:00
# OneDrive Client for Linux
2019-08-27 05:23:18 +02:00
[![Version ](https://img.shields.io/github/v/release/abraunegg/onedrive )](https://github.com/abraunegg/onedrive/releases)
[![Release Date ](https://img.shields.io/github/release-date/abraunegg/onedrive )](https://github.com/abraunegg/onedrive/releases)
[![Travis CI ](https://img.shields.io/travis/com/abraunegg/onedrive )](https://travis-ci.com/abraunegg/onedrive/builds)
2020-05-09 02:37:28 +02:00
[![Docker Build ](https://img.shields.io/docker/cloud/automated/driveone/onedrive )](https://hub.docker.com/r/driveone/onedrive)
2019-08-27 05:23:18 +02:00
[![Docker Pulls ](https://img.shields.io/docker/pulls/driveone/onedrive )](https://hub.docker.com/r/driveone/onedrive)
2020-09-30 01:11:11 +02:00
A free Microsoft OneDrive Client which supports OneDrive Personal, OneDrive for Business, OneDrive for Office365 and SharePoint.
2020-04-18 22:33:59 +02:00
2020-08-20 00:20:32 +02:00
This powerful and highly configurable client can run on all major Linux distributions, FreeBSD, or as a Docker container. It supports one-way and two-way sync capabilities and securely connects to Microsoft OneDrive services.
2019-08-31 22:48:20 +02:00
2020-04-20 05:29:42 +02:00
This client is a 'fork' of the [skilion ](https://github.com/skilion/onedrive ) client which was abandoned in 2018.
2020-04-20 05:29:08 +02:00
2019-01-06 17:02:58 +01:00
## Features
* State caching
2021-11-23 20:54:28 +01:00
* Real-Time local file monitoring with inotify
* Real-Time syncing of remote updates via webhooks
2019-08-01 21:55:43 +02:00
* File upload / download validation to ensure data integrity
2019-01-06 17:02:58 +01:00
* Resumable uploads
* Support OneDrive for Business (part of Office 365)
2020-06-27 11:10:37 +02:00
* Shared Folder support for OneDrive Personal and OneDrive Business accounts
* SharePoint / Office365 Shared Libraries
2019-08-01 21:55:43 +02:00
* Desktop notifications via libnotify
2020-01-02 22:47:04 +01:00
* Dry-run capability to test configuration changes
* Prevent major OneDrive accidental data deletion after configuration change
2020-06-16 23:57:14 +02:00
* Support for National cloud deployments (Microsoft Cloud for US Government, Microsoft Cloud Germany, Azure and Office 365 operated by 21Vianet in China)
2021-10-10 03:53:15 +02:00
* Supports single & multi-tenanted applications
* Supports rate limiting of traffic
2015-09-22 18:31:10 +02:00
2019-01-06 17:02:58 +01:00
## What's missing
2020-09-30 01:11:11 +02:00
* Ability to encrypt/decrypt files on-the-fly when uploading/downloading files from OneDrive
2020-08-20 00:20:32 +02:00
* Support for Windows 'On-Demand' functionality so file is only downloaded when accessed locally
2022-02-11 00:59:45 +01:00
## External Enhancements
* A GUI for configuration management: [OneDrive Client for Linux GUI ](https://github.com/bpozdena/OneDriveGUI )
* Colorful log output terminal modification: [OneDrive Client for Linux Colorful log Output ](https://github.com/zzzdeb/dotfiles/blob/master/scripts/tools/onedrive_log )
* System Tray Icon: [OneDrive Client for Linux System Tray Icon ](https://github.com/DanielBorgesOliveira/onedrive_tray )
2020-06-16 23:57:14 +02:00
2021-02-04 07:02:31 +01:00
## Frequently Asked Questions
Refer to [Frequently Asked Questions ](https://github.com/abraunegg/onedrive/wiki/Frequently-Asked-Questions )
2021-03-12 19:11:44 +01:00
## Have a question
2021-03-10 23:57:36 +01:00
If you have a question or need something clarified, please raise a new disscussion post [here ](https://github.com/abraunegg/onedrive/discussions )
## Reporting an Issue or Bug
2017-06-16 16:44:48 +02:00
If you encounter any bugs you can report them here on Github. Before filing an issue be sure to:
2019-01-06 17:02:58 +01:00
1. Check the version of the application you are using `onedrive --version` and ensure that you are running either the latest [release ](https://github.com/abraunegg/onedrive/releases ) or built from master.
2. Fill in a new bug report using the [issue template ](https://github.com/abraunegg/onedrive/issues/new?template=bug_report.md )
3. Generate a debug log for support using the following [process ](https://github.com/abraunegg/onedrive/wiki/Generate-debug-log-for-support )
2021-02-26 00:45:17 +01:00
* 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 ](https://pastebin.com/ ) 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
2020-04-20 04:37:19 +02:00
## Known issues
2021-02-04 07:02:31 +01:00
Refer to [docs/known-issues.md ](https://github.com/abraunegg/onedrive/blob/master/docs/known-issues.md )
2020-08-20 00:20:32 +02:00
## Documentation and Configuration Assistance
2021-02-26 00:45:17 +01:00
### Installing from Distribution Packages or Building the OneDrive Client for Linux from source
2021-02-04 07:02:31 +01:00
Refer to [docs/INSTALL.md ](https://github.com/abraunegg/onedrive/blob/master/docs/INSTALL.md )
2020-08-20 00:20:32 +02:00
### Configuration and Usage
2021-02-04 07:02:31 +01:00
Refer to [docs/USAGE.md ](https://github.com/abraunegg/onedrive/blob/master/docs/USAGE.md )
2020-08-20 00:20:32 +02:00
### Configure OneDrive Business Shared Folders
2021-02-04 07:02:31 +01:00
Refer to [docs/BusinessSharedFolders.md ](https://github.com/abraunegg/onedrive/blob/master/docs/BusinessSharedFolders.md )
2020-08-20 00:20:32 +02:00
### Configure SharePoint / Office 365 Shared Libraries (Business or Education)
2021-02-04 07:02:31 +01:00
Refer to [docs/SharePoint-Shared-Libraries.md ](https://github.com/abraunegg/onedrive/blob/master/docs/SharePoint-Shared-Libraries.md )
2020-08-20 00:20:32 +02:00
### Configure National Cloud support
2021-02-04 07:02:31 +01:00
Refer to [docs/national-cloud-deployments.md ](https://github.com/abraunegg/onedrive/blob/master/docs/national-cloud-deployments.md )
2020-08-20 00:20:32 +02:00
### Docker support
2021-02-04 07:02:31 +01:00
Refer to [docs/Docker.md ](https://github.com/abraunegg/onedrive/blob/master/docs/Docker.md )