From 2b32c3a4974f2ed132d9d07ffabd152e214bd204 Mon Sep 17 00:00:00 2001 From: abraunegg Date: Mon, 26 Jul 2021 14:41:54 +1000 Subject: [PATCH] Add new document for Debian and Ubuntu package installs via OpenSuSE Build Service (#1588) * Add new document to detail package installation on Debian and Ubuntu platforms via OpenSuSE Build Service * Depreciate recommending Ubuntu PPA due to dependency on Debian packages --- docs/INSTALL.md | 18 +++--- docs/ubuntu-package-install.md | 114 +++++++++++++++++++++++++++++++++ 2 files changed, 123 insertions(+), 9 deletions(-) create mode 100644 docs/ubuntu-package-install.md diff --git a/docs/INSTALL.md b/docs/INSTALL.md index e7227bc9..a4ee79db 100644 --- a/docs/INSTALL.md +++ b/docs/INSTALL.md @@ -12,20 +12,20 @@ Distribution packages may be of an older release when compared to the latest rel |---------------------------------|------------------------------------------------------------------------------|:---------------:|:----:|:------:|:-----:|:-------:|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Alpine Linux | [onedrive](https://pkgs.alpinelinux.org/packages?name=onedrive&branch=edge) |Alpine Linux Edge package|not_supported|supported|not_supported|supported | | | Arch Linux

Manjaro Linux | [onedrive-abraunegg](https://aur.archlinux.org/packages/onedrive-abraunegg/) |AUR package|supported|supported|supported|supported | Install via: `pamac build onedrive-abraunegg` from the Arch Linux User Repository (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 -| Debian | [onedrive](https://packages.debian.org/search?keywords=onedrive) |Debian Testing package|supported|supported|supported|supported| | +| Debian | [onedrive](https://packages.debian.org/search?keywords=onedrive) |Debian Testing package|supported|supported|supported|supported| It is recommended that for Debian that you install from OpenSuSE Build Service using the Debian Package Install [Instructions](ubuntu-package-install.md) | | Fedora | [onedrive](https://koji.fedoraproject.org/koji/packageinfo?packageID=26044) |Fedora Rawhide package|supported|supported|supported|supported| | | Gentoo | [onedrive](https://gpo.zugaina.org/net-misc/onedrive) | No API Available |supported|supported|not_supported|not_supported| | | NixOS | [onedrive](https://search.nixos.org/packages?channel=20.09&from=0&size=50&sort=relevance&query=onedrive)|nixpkgs unstable package|not_supported|supported|not_supported|not_supported| Use package `onedrive` either by adding it to `configuration.nix` or by using the command `nix-env -iA .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](https://github.com/NixOS/nixpkgs/pull/77734#issuecomment-575874225). | -| openSUSE | [onedrive](https://software.opensuse.org/package/onedrive) |openSUSE Tumbleweed package|supported|supported|not_supported|not_supported| | +| OpenSuSE | [onedrive](https://software.opensuse.org/package/onedrive) |openSUSE Tumbleweed package|supported|supported|not_supported|not_supported| | +| OpenSuSE Build Service | [onedrive](https://build.opensuse.org/project/show/home:npreining:debian-ubuntu-onedrive) | No API Available |supported|supported|supported|supported| Package Build Service for Debian and Ubuntu | | Raspbian | [onedrive](https://archive.raspbian.org/raspbian/pool/main/o/onedrive/) |Raspbian Stable package|not_supported|not_supported|supported|not_supported| | | Slackware | [onedrive](https://slackbuilds.org/repository/14.2/network/onedrive/) |SlackBuilds package|supported|supported|not_supported|not_supported| | | Solus | [onedrive](https://dev.getsol.us/search/query/FB7PIf1jG9Z9/#R) |Solus package|supported|supported|not_supported|not_supported| | -| Ubuntu 18.04 | [onedrive](https://packages.ubuntu.com/bionic/onedrive) |Ubuntu 18.04 package|supported|supported|supported|not_supported| | -| Ubuntu 20.04 | [onedrive](https://packages.ubuntu.com/focal/onedrive) |Ubuntu 20.04 package|not_supported|supported|supported|supported| | -| Ubuntu 20.10 | [onedrive](https://packages.ubuntu.com/groovy/onedrive) |Ubuntu 20.10 package|not_supported|supported|supported|supported| | -| Ubuntu 21.04 | [onedrive](https://packages.ubuntu.com/hirsute/onedrive) |Ubuntu 21.04 package|not_supported|supported|supported|supported| | -| Ubuntu PPA | [onedrive](https://launchpad.net/~yann1ck/+archive/ubuntu/onedrive) |Ubuntu PPA package |not_supported|supported|not_supported|not_supported| Install via the Ubuntu PPA Archive:

`sudo add-apt-repository ppa:yann1ck/onedrive`
`sudo apt-get update`
`sudo apt install onedrive`| -| Void Linux | [onedrive](https://voidlinux.org/packages/?arch=x86_64&q=onedrive) |Void Linux x86_64 package|supported|supported|not_supported|not_supported| | +| Ubuntu 18.04 | [onedrive](https://packages.ubuntu.com/bionic/onedrive) |Ubuntu 18.04 package|supported|supported|supported|not_supported| **Note:** Do not install from Ubuntu Universe

You must compile from source for this version of Ubuntu | +| Ubuntu 20.04 | [onedrive](https://packages.ubuntu.com/focal/onedrive) |Ubuntu 20.04 package|not_supported|supported|supported|supported| **Note:** Do not install from Ubuntu Universe

Install from OpenSuSE Build Service using the Ubuntu Package Install [Instructions](ubuntu-package-install.md) | +| Ubuntu 20.10 | [onedrive](https://packages.ubuntu.com/groovy/onedrive) |Ubuntu 20.10 package|not_supported|supported|supported|supported| **Note:** Do not install from Ubuntu Universe

Install from OpenSuSE Build Service using the Ubuntu Package Install [Instructions](ubuntu-package-install.md) | +| Ubuntu 21.04 | [onedrive](https://packages.ubuntu.com/hirsute/onedrive) |Ubuntu 21.04 package|not_supported|supported|supported|supported| **Note:** Do not install from Ubuntu Universe

Install from OpenSuSE Build Service using the Ubuntu Package Install [Instructions](ubuntu-package-install.md) | +| Void Linux | [onedrive](https://voidlinux.org/packages/?arch=x86_64&q=onedrive) |Void Linux x86_64 package|supported|supported|not_supported|not_supported| | #### Important information for all Ubuntu and Ubuntu based distribution users: This information is specifically for the following platforms and distributions: @@ -35,7 +35,7 @@ This information is specifically for the following platforms and distributions: * POP OS * Peppermint OS -Whilst there are [onedrive](https://packages.ubuntu.com/search?keywords=onedrive&searchon=names&suite=all§ion=all) packages available for Ubuntu, do not install 'onedrive' from these packages via `apt install onedrive` without using the above PPA. The default Ubuntu Universe packages are out-of-date and should not be used. If you wish to use a package, it is highly recommended that you utilise the Ubuntu PPA listed above. If the Ubuntu PPA does not support your distribution or version, your only option is to compile from source using the relevant Ubuntu instructions below. +Whilst there are [onedrive](https://packages.ubuntu.com/search?keywords=onedrive&searchon=names&suite=all§ion=all) packages available for Ubuntu, do not install 'onedrive' from these packages via `apt install onedrive`. The default Ubuntu Universe packages are out-of-date and are not supported and should not be used. If you wish to use a package, it is highly recommended that you utilise the [OpenSuSE Build Service](https://build.opensuse.org/project/show/home:npreining:debian-ubuntu-onedrive) to install packages for these platforms. If the OpenSuSE Build Service does not cater for your version, your only option is to build from source. If you wish to change this situation so that you can just use 'apt install onedrive', consider becoming the Ubuntu package maintainer and contribute back to the community. diff --git a/docs/ubuntu-package-install.md b/docs/ubuntu-package-install.md new file mode 100644 index 00000000..b9aa32a5 --- /dev/null +++ b/docs/ubuntu-package-install.md @@ -0,0 +1,114 @@ +# Installation of 'onedrive' package on Debian and Ubuntu + +This document covers the appropriate steps to install the 'onedrive' client using the provided packages for Debian and Ubuntu. + +#### Important information for all Ubuntu and Ubuntu based distribution users: +This information is specifically for the following platforms and distributions: +* Ubuntu +* Lubuntu +* Linux Mint +* POP OS +* Peppermint OS + +Whilst there are [onedrive](https://packages.ubuntu.com/search?keywords=onedrive&searchon=names&suite=all§ion=all) Universe packages available for Ubuntu, do not install 'onedrive' from these packages via `apt install onedrive`. The default Ubuntu Universe packages are out-of-date and are not supported and should not be used. + +## Distribution Package Install Instructions + +### Distribution: Debian 10 +The packages support the following platform architectures: +|  i686  | x86_64 | ARMHF | AARCH64 | +|:----:|:------:|:-----:|:-------:| +|supported|supported|supported|supported| | + +#### Step 1: Update /etc/apt/sources.list +Add the following to the end of your `/etc/apt/sources.list` file: +```text +deb https://download.opensuse.org/repositories/home:/npreining:/debian-ubuntu-onedrive/Debian_10/ ./ +``` + +#### Step 2: Download and add the release key +1. Download the 'Release.key' file: `wget https://download.opensuse.org/repositories/home:/npreining:/debian-ubuntu-onedrive/Debian_10/Release.key` +2. Add the 'Release.key' file to your apt key repository: `apt-key add ./Release.key` + +#### Step 3: Update your apt package cache +1. Run: `apt-get update` + +#### Step 4: Install 'onedrive' +1. Run: `apt install onedrive` + +### Distribution: Ubuntu 20.04 +The packages support the following platform architectures: +|  i686  | x86_64 | ARMHF | AARCH64 | +|:----:|:------:|:-----:|:-------:| +not_supported|supported|supported|supported| | + +#### Step 1: Update /etc/apt/sources.list +Add the following to the end of your `/etc/apt/sources.list` file: +```text +deb https://download.opensuse.org/repositories/home:/npreining:/debian-ubuntu-onedrive/xUbuntu_20.04/ ./ +``` + +#### Step 2: Download and add the release key +1. Download the 'Release.key' file: `wget https://download.opensuse.org/repositories/home:/npreining:/debian-ubuntu-onedrive/xUbuntu_20.04/Release.key` +2. Add the 'Release.key' file to your apt key repository: `apt-key add ./Release.key` + +#### Step 3: Update your apt package cache +1. Run: `apt-get update` + +#### Step 4: Install 'onedrive' +1. Run: `apt install onedrive` + +### Distribution: Ubuntu 20.10 +The packages support the following platform architectures: +|  i686  | x86_64 | ARMHF | AARCH64 | +|:----:|:------:|:-----:|:-------:| +not_supported|supported|supported|supported| | + +#### Step 1: Update /etc/apt/sources.list +Add the following to the end of your `/etc/apt/sources.list` file: +```text +deb https://download.opensuse.org/repositories/home:/npreining:/debian-ubuntu-onedrive/xUbuntu_20.10/ ./ +``` + +#### Step 2: Download and add the release key +1. Download the 'Release.key' file: `wget https://download.opensuse.org/repositories/home:/npreining:/debian-ubuntu-onedrive/xUbuntu_20.10/Release.key` +2. Add the 'Release.key' file to your apt key repository: `apt-key add ./Release.key` + +#### Step 3: Update your apt package cache +1. Run: `apt-get update` + +#### Step 4: Install 'onedrive' +1. Run: `apt install onedrive` + +### Distribution: Ubuntu 21.04 +The packages support the following platform architectures: +|  i686  | x86_64 | ARMHF | AARCH64 | +|:----:|:------:|:-----:|:-------:| +not_supported|supported|supported|supported| | + +#### Step 1: Update /etc/apt/sources.list +Add the following to the end of your `/etc/apt/sources.list` file: +```text +deb https://download.opensuse.org/repositories/home:/npreining:/debian-ubuntu-onedrive/xUbuntu_21.04/ ./ +``` + +#### Step 2: Download and add the release key +1. Download the 'Release.key' file: `wget https://download.opensuse.org/repositories/home:/npreining:/debian-ubuntu-onedrive/xUbuntu_21.04/Release.key` +2. Add the 'Release.key' file to your apt key repository: `apt-key add ./Release.key` + +#### Step 3: Update your apt package cache +1. Run: `apt-get update` + +#### Step 4: Install 'onedrive' +1. Run: `apt install onedrive` + +## Known Issues with Installing from the above packages +The 'onedrive' client will automatically startup post 'authentication' without any further actions. In some circumstances this may be highly undesirable. + +This is because, when the package is installed, the following symbolic link is created: +```text +Created symlink /etc/systemd/user/default.target.wants/onedrive.service → /usr/lib/systemd/user/onedrive.service. +``` + +This issue is being tracked by: [#1274](https://github.com/abraunegg/onedrive/issues/1274) +