mirror of https://github.com/abraunegg/onedrive synced 2026-03-14 14:35:46 +01:00

abraunegg 61e5a1edb6

Implement FR #3209 : Add native support for authentication via Intune dbus interface (#3274 )

* Adds support for calling `acquireTokenInteractively` and `acquireTokenSilently` via D-Bus
* Parses and handles the full `brokerTokenResponse` object returned by the Intune broker
* Stores and reuses `account` data to enable silent token refresh without repeated interactive authentication
* Ensures the access token and its expiry time are properly calculated and stored for consistent token management
* Fallback to interactive authentication is triggered if silent authentication fails

2025-05-26 17:14:50 +10:00

29 KiB

Raw Blame History

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

Installing or Upgrading using Distribution Packages

This project has been packaged for the following Linux distributions as per below. The current client release is:

Only the current release version or greater is supported. Earlier versions are not supported and should not be installed or used.

Caution

Distribution packages may be of an older release when compared to the latest release that is available. If any package version indicator below is 'red' for your distribution, it is recommended that you build from source. Do not install the software from the available distribution package. If a package is out of date, please contact the package maintainer for resolution.

Distribution	Package Name & Package Link	PKG_Version	i686	x86_64	ARMHF	AARCH64	Extra Details
Alpine Linux	onedrive		❌	✔	❌	✔
Arch Linux Manjaro Linux	onedrive-abraunegg		✔	✔	✔	✔	Install via: `pamac build onedrive-abraunegg` from the Arch Linux User Repository (AUR) Note: You must first install 'base-devel' as this is a pre-requisite for using the AUR Note: If asked regarding a provider for 'd-runtime' and 'd-compiler', select 'liblphobos' and 'ldc' Note: System must have at least 1GB of memory & 1GB swap space
CentOS 8	onedrive		❌	✔	❌	✔	Note: You must install the EPEL Repository first. Install via `sudo dnf install onedrive`
CentOS 9	onedrive		❌	✔	❌	✔	Note: You must install the EPEL Repository first. Install via `sudo dnf install onedrive`
Debian 11	onedrive		✔	✔	✔	✔	Note: Do not install from Debian Package Repositories as the package is obsolete and is not supported For a supported application version, it is recommended that for Debian 11 that you install from OpenSuSE Build Service using the Debian Package Install Instructions
Debian 12	onedrive		✔	✔	✔	✔	Note: Do not install from Debian Package Repositories as the package is obsolete and is not supported For a supported application version, it is recommended that for Debian 12 that you install from OpenSuSE Build Service using the Debian Package Install Instructions
Debian Sid	onedrive		✔	✔	✔	✔
Fedora	onedrive		✔	✔	✔	✔	Use package `onedrive` from the Fedora Package Repositories. Install via `sudo dnf install onedrive`
FreeBSD	onedrive		❌	✔	❌	❌
Gentoo	onedrive		❌	✔	❌	❌	Install via: `emerge net-misc/onedrive`
Homebrew	onedrive		❌	✔	❌	❌
Linux Mint 20.x	onedrive		❌	✔	✔	✔	Note: Do not install from Linux Mint Repositories as the package is obsolete and is not supported For a supported application version, it is recommended that for Linux Mint that you install from OpenSuSE Build Service using the Ubuntu Package Install Instructions
Linux Mint 21.x	onedrive		❌	✔	✔	✔	Note: Do not install from Linux Mint Repositories as the package is obsolete and is not supported For a supported application version, it is recommended that for Linux Mint that you install from OpenSuSE Build Service using the Ubuntu Package Install Instructions
Linux Mint 22.x	onedrive		❌	✔	✔	✔	Note: Do not install from Linux Mint Repositories as the package is obsolete and is not supported For a supported application version, it is recommended that for Linux Mint that you install from OpenSuSE Build Service using the Ubuntu Package Install Instructions
NixOS	onedrive		❌	✔	❌	❌	Use package `onedrive` either by adding it to `configuration.nix` or by using the command `nix-env -iA <channel name>.onedrive`. This does not install a service. To install a service, use unstable channel (will stabilize in 20.09) and add `services.onedrive.enable=true` in `configuration.nix`. You can also add a custom package using the `services.onedrive.package` option (recommended since package lags upstream). Enabling the service installs a default package too (based on the channel). You can also add multiple onedrive accounts trivially, see documentation.
OpenSuSE	onedrive		✔	✔	❌	❌
OpenSuSE Build Service	onedrive	No API Available	✔	✔	✔	✔	Package Build Service for Debian and Ubuntu
Raspbian	onedrive		❌	❌	✔	✔	Note: Do not install from Raspbian Package Repositories as the package is obsolete and is not supported For a supported application version, it is recommended that for Raspbian that you install from OpenSuSE Build Service using the Debian Package Install Instructions
Slackware	onedrive		✔	✔	❌	❌
Solus	onedrive		❌	✔	❌	❌
Ubuntu 20.04 LTS	onedrive		❌	✔	✔	✔	Note: Do not install from Ubuntu Universe as the package is obsolete and is not supported For a supported application version, it is recommended that for Ubuntu that you install from OpenSuSE Build Service using the Ubuntu Package Install Instructions
Ubuntu 22.04 LTS	onedrive		❌	✔	✔	✔	Note: Do not install from Ubuntu Universe as the package is obsolete and is not supported For a supported application version, it is recommended that for Ubuntu that you install from OpenSuSE Build Service using the Ubuntu Package Install Instructions
Ubuntu 24.04 LTS	onedrive		❌	✔	✔	✔	Note: Do not install from Ubuntu Universe as the package is obsolete and is not supported For a supported application version, it is recommended that for Ubuntu that you install from OpenSuSE Build Service using the Ubuntu Package Install Instructions
Void Linux	onedrive		✔	✔	❌	❌

Building from Source - High Level Requirements

For successful compilation of this application, it's crucial that the build environment is equipped with a minimum of 1GB of memory and an additional 1GB of swap space.
Install the required distribution package dependencies covering the required development tools and development libraries for curl and sqlite
Install the Digital Mars D Compiler (DMD), LDC – the LLVM-based D Compiler, or, at least version 15 of the GNU D Compiler (GDC)

Important

To compile this application successfully, the minimum supported versions of each compiler are: DMD 2.088.0, LDC 1.18.0, and, GDC 15. Ensuring compatibility and optimal performance necessitates the use of these specific versions or their more recent updates.

Example for installing DMD Compiler

curl -fsS https://dlang.org/install.sh | bash -s dmd

Example for installing LDC Compiler

curl -fsS https://dlang.org/install.sh | bash -s ldc

Installing GDC

As stated above, you will need at least GDC version 15. If your distribution's repositories include a suitable version, you can install it from there. Common names for the GDC package are listed on the GDC website. If the package is unavailable or its version is too old, you can try building it from source following these instructions.

Distribution Package Dependencies

Dependencies: Arch Linux & Manjaro Linux

sudo pacman -S git make pkg-config curl sqlite dbus ldc

For GUI notifications the following is also necessary:

sudo pacman -S libnotify

Dependencies: CentOS 6.x / RHEL 6.x

CentOS 6.x and RHEL 6.x reached End of Life status on November 30th 2020 and is no longer supported.

Dependencies: CentOS 7.x / RHEL 7.x

CentOS 7.x and RHEL 7.x reached End of Life status on June 30th 2024 and is no longer supported.

Dependencies: Fedora > Version 18 / CentOS 8.x / CentOS 9.x / RHEL 8.x / RHEL 9.x

sudo dnf groupinstall 'Development Tools'
sudo dnf install libcurl-devel sqlite-devel dbus-devel
curl -fsS https://dlang.org/install.sh | bash -s dmd

For GUI notifications the following is also necessary:

sudo dnf install libnotify-devel

Dependencies: Fedora > Version 41

Fedora > 41 uses dnf5 which removes some deprecated aliases, specifically 'groupinstall' in this instance.

sudo dnf group install development-tools
sudo dnf install libcurl-devel sqlite-devel dbus-devel

Before running the dmd install you need to check for the option 'use-keyboxd' in your gnupg common.conf file and comment it out while running the install.

curl -fsS https://dlang.org/install.sh | bash -s dmd

Or you may get the following error:

myuser@fedora:~$ curl -fsS https://dlang.org/install.sh | bash -s dmd
Downloading https://dlang.org/d-keyring.gpg
######################################################################## 100.0%
gpg: Note: Specified keyrings are ignored due to option "use-keyboxd"
gpg: Signature made Thu 06 Mar 2025 10:45:29 GMT
gpg:                using RSA key F3F896F3274BBD9BBBA59058710592E7FB7AF6CA
gpg: Can't check signature: No public key
Invalid signature https://dlang.org/d-keyring.gpg.sig

For GUI notifications the following is also necessary:

sudo dnf install libnotify-devel

Dependencies: FreeBSD

pkg install bash bash-completion gmake pkgconf autoconf automake logrotate libinotify git sqlite3 ldc

For GUI notifications the following is also necessary:

pkg install libnotify

Note

Install the required FreeBSD packages as 'root' unless you have installed 'sudo'

Dependencies: Gentoo

Install the dependencies for the package:

sudo emerge --onlydeps net-misc/onedrive

GUI notifications can be enabled with the libnotify USE flag (which is the default on desktop profiles).

Dependencies: Ubuntu 16.x

Ubuntu Linux 16.x LTS reached the end of its five-year LTS window on April 30th 2021 and is no longer supported.

Dependencies: Ubuntu 18.x / Lubuntu 18.x

Ubuntu Linux 18.x LTS reached the end of its five-year LTS window on May 31th 2023 and is no longer supported.

Dependencies: Debian 9

Debian 9 reached the end of its five-year support window on June 30th 2022 and is no longer supported.

Dependencies: Debian 10 -> Debian 12 / Ubuntu 20.x -> Ubuntu 24.x - x86_64

These dependencies are also applicable for all Ubuntu based distributions such as:

Lubuntu
Linux Mint
POP OS
Peppermint OS

sudo apt install build-essential
sudo apt install libcurl4-openssl-dev libsqlite3-dev pkg-config git curl systemd-dev libdbus-1-dev
curl -fsS https://dlang.org/install.sh | bash -s dmd

For GUI notifications the following is also necessary:

sudo apt install libnotify-dev

Dependencies: Debian 11 and Raspbian (ARMHF) / Debian 12 / Raspbian / Ubuntu 22.x (ARM64)

Caution

The minimum LDC compiler version required to compile this application is 1.18.0, which is not available for Debian Buster or distributions based on Debian Buster. You are advised to first upgrade your platform distribution to one that is based on Debian Bullseye (Debian 11) or later.

These instructions were validated using:

Linux raspberrypi 5.10.92-v8+ #1514 SMP PREEMPT Mon Jan 17 17:39:38 GMT 2022 aarch64 (2022-01-28-raspios-bullseye-armhf-lite) using Raspberry Pi 3B (revision 1.2)
Linux raspberrypi 5.10.92-v8+ #1514 SMP PREEMPT Mon Jan 17 17:39:38 GMT 2022 aarch64 (2022-01-28-raspios-bullseye-arm64-lite) using Raspberry Pi 3B (revision 1.2)
Linux ubuntu 5.15.0-1005-raspi #5-Ubuntu SMP PREEMPT Mon Apr 4 12:21:48 UTC 2022 aarch64 aarch64 aarch64 GNU/Linux (ubuntu-22.04-preinstalled-server-arm64+raspi) using Raspberry Pi 3B (revision 1.2)

Important

For successful compilation of this application, it's crucial that the build environment is equipped with a minimum of 1GB of memory and an additional 1GB of swap space. To verify your system's swap space availability, you can use the swapon command. Ensuring these requirements are met is vital for the application's compilation process.

sudo apt install build-essential
sudo apt install libcurl4-openssl-dev libsqlite3-dev pkg-config git curl ldc systemd-dev libdbus-1-dev

For GUI notifications the following is also necessary:

sudo apt install libnotify-dev

Dependencies: OpenSuSE Leap 15.0

sudo zypper addrepo https://download.opensuse.org/repositories/devel:languages:D/openSUSE_Leap_15.0/devel:languages:D.repo
sudo zypper refresh
sudo zypper install gcc git libcurl-devel sqlite3-devel dmd phobos-devel phobos-devel-static dbus-1-devel

For GUI notifications the following is also necessary:

sudo zypper install libnotify-devel

Dependencies: OpenSuSE Leap 15.1

sudo zypper addrepo https://download.opensuse.org/repositories/devel:languages:D/openSUSE_Leap_15.1/devel:languages:D.repo
sudo zypper refresh
sudo zypper install gcc git libcurl-devel sqlite3-devel dmd phobos-devel phobos-devel-static dbus-1-devel

For GUI notifications the following is also necessary:

sudo zypper install libnotify-devel

Dependencies: OpenSuSE Leap 15.2

sudo zypper refresh
sudo zypper install gcc git libcurl-devel sqlite3-devel dmd phobos-devel phobos-devel-static dbus-1-devel

For GUI notifications the following is also necessary:

sudo zypper install libnotify-devel

Compilation & Installation

High Level Steps

Install the platform dependencies for your platform
Activate your DMD or LDC compiler if required
Clone the GitHub repository,
Run the 'configure' command then build the application and install it
Deactivate your DMD or LDC compiler if required

Linux: Building the application using the DMD Reference Compiler

Before cloning and compiling, if you have installed DMD via curl for your OS, you will need to activate DMD as per example below:

Run `source ~/dlang/dmd-2.088.0/activate` in your shell to use dmd-2.088.0.
This will setup PATH, LIBRARY_PATH, LD_LIBRARY_PATH, DMD, DC, and PS1.
Run `deactivate` later on to restore your environment.

Without performing this step, the compilation process will fail.

Note

Depending on your DMD version, substitute 2.088.0 above with your DMD version that is installed.

git clone https://github.com/abraunegg/onedrive.git
cd onedrive
./configure
make clean; make;
sudo make install

FreeBSD: Building the application using FreeBSD version of LDC

git clone https://github.com/abraunegg/onedrive.git
cd onedrive
./configure
gmake clean; gmake;
gmake install

Note

Install the application as 'root' unless you have installed 'sudo'

Linux: Building the application with GDC

First, make sure at least version 15 of GDC is available in your path:

$ gdc --version
gdc (Gentoo Hardened 15.0.1_pre20250413 p54) 15.0.1 20250413 (experimental)
Copyright (C) 2025 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Then, clone the repository and run the build commands:

git clone https://github.com/abraunegg/onedrive.git
cd onedrive
./configure
make clean; make;
sudo make install

If you have another D compiler installed on your system you may need to explicitly specify that you want to use GDC to the configure script. To do this replace the ./configure step above with:

./configure DC=gdc

Build options

GUI Notification Support

GUI notification support can be enabled using the configure switch --enable-notifications.

systemd service directory customisation support

Systemd service files are installed in the appropriate directories on the system, as provided by pkg-config systemd settings. If the need for overriding the deduced path are necessary, the two options --with-systemdsystemunitdir (for the Systemd system unit location), and --with-systemduserunitdir (for the Systemd user unit location) can be specified. Passing in no to one of these options disabled service file installation.

Additional Compiler Debug

By passing --enable-debug to the configure call, onedrive gets built with additional debug information, useful (for example) to get perf-issued figures.

Shell Completion Support

By passing --enable-completions to the configure call, shell completion functions are installed for bash, zsh and fish. The installation directories are determined as far as possible automatically, but can be overridden by passing --with-bash-completion-dir=<DIR>, --with-zsh-completion-dir=<DIR>, and --with-fish-completion-dir=<DIR> to configure.

Building using a different compiler (for example LDC)

ARMHF Architecture (Raspbian) and ARM64 Architecture (Ubuntu 22.x / Debian 11 / Debian 12 / Raspbian)

Caution

The minimum LDC compiler version required to compile this application is 1.18.0, which is not available for Debian Buster or distributions based on Debian Buster. You are advised to first upgrade your platform distribution to one that is based on Debian Bullseye (Debian 11) or later.

Important

For successful compilation of this application, it's crucial that the build environment is equipped with a minimum of 1GB of memory and an additional 1GB of swap space. To verify your system's swap space availability, you can use the swapon command. Ensuring these requirements are met is vital for the application's compilation process.

Note

The 'configure' step will detect the correct version of LDC to be used when compiling the client under ARMHF and ARM64 CPU architectures.

git clone https://github.com/abraunegg/onedrive.git
cd onedrive
./configure; make clean; make;
sudo make install

Upgrading the client

If you have installed the client from a distribution package, the client will be updated when the distribution package is updated by the package maintainer and will be updated to the new application version when you perform your package update.

If you have built the client from source, to upgrade your client, it is recommended that you first uninstall your existing 'onedrive' binary (see below), then re-install the client by re-cloning, re-compiling and re-installing the client again to install the new version.

Note

Following the uninstall process will remove all client components including all systemd files, including any custom files created for specific access such as SharePoint Libraries.

You can optionally choose to not perform this uninstallation step, and simply re-install the client by re-cloning, re-compiling and re-installing the client again - however the risk here is that you end up with two onedrive client binaries on your system, and depending on your system search path preferences, this will determine which binary is used.

Caution

Before performing any upgrade, it is highly recommended for you to stop any running systemd service if applicable to ensure that these services are restarted using the updated client version.

Post re-install, to confirm that you have the new version of the client installed, use onedrive --version to determine the client version that is now installed.

Uninstalling the client

Uninstalling the client if installed from distribution package

Follow your distribution documentation to uninstall the package that you installed

Uninstalling the client if installed and built from source

From within your GitHub repository clone, perform the following to remove the 'onedrive' binary:

sudo make uninstall

If you are not upgrading your client, to remove your application state and configuration, perform the following additional step:

rm -rf ~/.config/onedrive

Important

If you are using the --confdir option, substitute ~/.config/onedrive for the correct directory storing your client configuration.

If you want to just delete the application key, but keep the items database:

rm -f ~/.config/onedrive/refresh_token

29 KiB Raw Blame History Unescape Escape

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

Installing or Upgrading using Distribution Packages

Building from Source - High Level Requirements

Example for installing DMD Compiler

Example for installing LDC Compiler

Installing GDC

Distribution Package Dependencies

Dependencies: Arch Linux & Manjaro Linux

Dependencies: CentOS 6.x / RHEL 6.x

Dependencies: CentOS 7.x / RHEL 7.x

Dependencies: Fedora > Version 18 / CentOS 8.x / CentOS 9.x / RHEL 8.x / RHEL 9.x

Dependencies: Fedora > Version 41

Dependencies: FreeBSD

Dependencies: Gentoo

Dependencies: Ubuntu 16.x

Dependencies: Ubuntu 18.x / Lubuntu 18.x

Dependencies: Debian 9

Dependencies: Debian 10 -> Debian 12 / Ubuntu 20.x -> Ubuntu 24.x - x86_64

Dependencies: Debian 11 and Raspbian (ARMHF) / Debian 12 / Raspbian / Ubuntu 22.x (ARM64)

Dependencies: OpenSuSE Leap 15.0

Dependencies: OpenSuSE Leap 15.1

Dependencies: OpenSuSE Leap 15.2

Compilation & Installation

High Level Steps

Linux: Building the application using the DMD Reference Compiler

FreeBSD: Building the application using FreeBSD version of LDC

Linux: Building the application with GDC

Build options

GUI Notification Support

systemd service directory customisation support

Additional Compiler Debug

Shell Completion Support

Building using a different compiler (for example LDC)

ARMHF Architecture (Raspbian) and ARM64 Architecture (Ubuntu 22.x / Debian 11 / Debian 12 / Raspbian)

Upgrading the client

Uninstalling the client

Uninstalling the client if installed from distribution package

Uninstalling the client if installed and built from source

29 KiB

Raw Blame History