Important
OneDrive Client for Linux v2.5.x contains a database schema change to support the additional functionality and bug fixes in the v2.5.x branch. As such, on your first use of a v2.5.x client version, if your local database has not already been upgraded by a previous v2.5.x release, the database schema will be updated and the client will perform an entire re-validation of your data - both locally and online which may take an extended period of time.
Caution
OneDrive Client for Linux v2.5.x introduces significant changes and is not backwards compatible with v2.4.x. Please ensure that you do not use both v2.5.x and v2.4.x clients with the same Microsoft OneDrive account simultaneously - whether on the same or different systems. If you upgrade to v2.5.x, all your clients must be updated to this version. However, you can revert to v2.4.x at any time if necessary, but do not run different versions at the same time on any system.
Caution
The application has been completely re-written in version 2.5.x, leading to changes in how many features and functions operate compared to version 2.4.x. It is crucial to read the updated documentation thoroughly.
Feature Requests
- Implement Feature Request: Added CI smoke test for monitor-mode clean shutdown across Ubuntu and Fedora (#3678)
- Implement Feature Request: Added support for Microsoft Identity Broker 3.0.1 (#3686)
- Implement Feature Request: Added push-triggered E2E testing across Personal, Business and SharePoint accounts with 64 test cases and dedicated Shared Folder testing (#3644)
- Implement Feature Request: Implemented stream hashing to support 'on-demand' development work (#3653)
- Implement Feature Request: Added
--mirror-local-stateto ensure online state is a mirror of local state (#3742) - Implement Feature Request: Added capability to display the Admin Consent URL via
--display-admin-consent-url(#3739) - Implement Feature Request: Added a new SVG notification icon for improved desktop integration with GNOME and KDE environments. (#3743)
- Implement Feature Request: Implemented GUI-based OAuth callback handling using local loopback listener (#3750)
Bug Fixes
- Fix Bug: Fix that the internal websocket trigger is not woken to sync with
--download-only(#3631) - Fix Bug: Fix internal crash when WebSocket initialisation fails in monitor mode (#3639)
- Fix Bug: Fix that broken symlinks log error despite
skip_symlinks = true(#3656) - Fix Bug: Fix 'sync_list' retention handling so
--download-only --cleanup-local-filesno longer removes directories that should be preserved (#3657) - Fix Bug: Fix
skip_sizeflagging for local files is respected (#3659) - Fix Bug: Fix reserved Windows device name validation to block names with extensions (e.g. CON.txt, NUL.tar.gz) (#3661)
- Fix Bug: Fix crash when parsing invalid 'resume_download.*' metadata during
--resync(#3668) - Fix Bug: Fix to ensure use of local timestamp when uploading files when using
--upload-only&--local-first(#3669) - Fix Bug: Fix SIGSEGV during shutdown caused by logging subsystem teardown race condition (#3676)
- Fix Bug: Fix to defer local directory recreation when processing simulated /delta response (#3682)
- Fix Bug: Fix SIGSEGV on shutdown, implement signal-safe termination handling, and preserve itemdb thread safety (#3687)
- Fix Bug: Fix to prevent new transfers during SIGINT shutdown and support forced transfer abort (#3691)
- Fix Bug: Fix relocated shared-folder shortcut path reconstruction (#3690)
- Fix Bug: Fix that empty directories included by 'sync_list' are added to the database but not created locally (#3703)
- Fix Bug: Fix 'sync_list' wildcard exclusion rules can incorrectly exclude ancestor directories (#3707)
- Fix Bug: Fix that
azure_tenant_identries for intune based authentication were being ignored (#3711) - Fix Bug: Fix inotify move handling so local file and directory moves within sync_dir are processed as remote moves instead of delete/re-upload operations. (#3720)
- Fix Bug: Fix impact of the official Microsoft Graph API 'sharedWithMe' deprecation on --sync-shared-files functionality (#3729)
- Fix Bug: Fix SharePoint Shared Library query failure where the application incorrectly reports that 'onedrive' is already running (#3734)
- Fix Bug: Fix that CurlEngine 'fresh_connect' option may not be reset after successful retry, impacting connection reuse (#3735)
- Fix Bug: Fix that Transfer Metrics duration includes non-transfer processing time (#3737)
- Fix Bug: Fix download error handling so filesystem attribute failures are handled cleanly instead of interrupting file downloads. (#3741)
- Fix Bug: Fix single-tenant authentication redirect URI handling and add administrator consent support (#3745)
- Fix Bug: Fix elapsedTime calculation for monitor loop cycles (#3749)
- Fix Bug: Fix monitor mode stability and long-running delta processing efficiency (#3754)
- Fix Bug: Fix FreeBSD RSS memory telemetry calculation (#3757)
- Fix Bug: Harden monitor lifecycle, event handling, and DB reconciliation (#3756)
- Fix Bug: Avoid duplicate online item conversion during modified file upload (#3759)
- Fix Bug: Reduce idle CPU usage in WebSocket monitor loop (#3762)
- Fix Bug: Add the missing
remove_source_foldersentry to--display-configoutput. (#3764)
Other Changes | Fixes
- Enhance logging output for
safeSetTimes()when the client runtime user does not own the file requiring timestamp changes (#3654) - Optimise monitor cleanup cadence for download-only mode (#3697)
- Remove from code deprecated commands (--synchronize and --get-O365-drive-id) in v2.5.0 (#3732)
- Improve delta processing performance and reduce GC overhead (#3746)
- Reduce forced garbage collection in synchronisation and CurlEngine cleanup paths (#3748)
- Improve remote deletion success and failure logging (#3752)
- Optimise client-side filtering directory mask evaluation (#3755)
- Clarify error message for 'sync_list' rule (#3761)
- Updated all supported Docker build environments to use current upstream base images and toolchains for improved security, maintenance, and long-term support.
- Updated completion files to align to release application functionality
- Updated 'config' file to align to release application functionality
- Updated documentation
Known Issues
- Refer to known-issues.md
Outstanding Issues
- Refer to Open Issues