nextcloud-desktop/doc/installing.rst
Michael Schuster b552c77128 Docs: Be slightly more modern and use 64-bit examples
Signed-off-by: Michael Schuster <michael@schuster.ms>
2020-10-05 07:18:35 +00:00

8.6 KiB

Installing the Desktop Synchronization Client

You can download the latest version of the Nextcloud Desktop Synchronization Client from the Nextcloud download page. There are clients for Linux, macOs, and Microsoft Windows.

Installation on Mac OS X and Windows is the same as for any software application: download the program and then double-click it to launch the installation, and then follow the installation wizard. After it is installed and configured the sync client will automatically keep itself updated; see autoupdate for more information.

Linux users must follow the instructions on the download page to add the appropriate repository for their Linux distribution, install the signing key, and then use their package managers to install the desktop sync client. Linux users will also update their sync clients via package manager, and the client will display a notification when an update is available.

Linux users must also have a password manager enabled, such as GNOME Keyring or KWallet, so that the sync client can login automatically.

You will also find links to source code archives and older versions on the download page.

System Requirements

  • Windows 8.1+
  • macOS 10.12+ (64-bit only)
  • macOS 10.10 & 10.11 (64-bit and up to client legacy version 2.6.5 only)
  • CentOS 6 & 7 (64-bit only)
  • Debian 8.0 & 9.0
  • Fedora 25 & 26 & 27
  • Ubuntu 16.04 & 17.04 & 17.10
  • openSUSE Leap 42.2 & 42.3

Note

For Linux distributions, we support, if technically feasible, the latest 2 versions per platform and the previous LTS.

Customizing the Windows Installation

If you just want to install Nextcloud Desktop Synchronization Client on your local system, you can simply launch the .msi file and configure it in the wizard that pops up.

Features

The MSI installer provides several features that can be installed or removed individually, which you can also control via command-line, if you are automating the installation, then run the following command:

msiexec /passive /i Nextcloud-x.y.z-x64.msi

The command will install the Nextcloud Desktop Synchronization Client into the default location with the default features enabled. If you want to disable, e.g., desktop shortcut icons you can simply change the above command to the following:

msiexec /passive /i Nextcloud-x.y.z-x64.msi REMOVE=DesktopShortcut

See the following table for a list of available features:

Feature Enabled by default Description Property to disable
Client Yes, required The actual client
DesktopShortcut Yes Adds a shortcut to the desktop NO_DESKTOP_SHORTCUT
StartMenuShortcuts Yes Adds a shortcut to the start menu NO_START_MENU_SHORTCUTS
ShellExtensions Yes Adds Explorer integration NO_SHELL_EXTENSIONS

Installation

You can also choose to only install the client itself by using the following command:

msiexec /passive /i Nextcloud-x.y.z-x64.msi ADDDEFAULT=Client

If you for instance want to install everything but the DesktopShortcut and the ShellExtensions feature, you have two possibilities:

  1. You explicitly name all the features you actually want to install (whitelist) where Client is always installed anyway:

msiexec /passive /i Nextcloud-x.y.z-x64.msi ADDDEFAULT=StartMenuShortcuts

  1. You pass the NO_DESKTOP_SHORTCUT and NO_SHELL_EXTENSIONS properties:

msiexec /passive /i Nextcloud-x.y.z-x64.msi NO_DESKTOP_SHORTCUT="1" NO_SHELL_EXTENSIONS="1"

Note

The Nextcloud .msi remembers these properties, so you don't need to specify them on upgrades.

Note

You cannot use these to change the installed features, if you want to do that, see the next section.

Changing Installed Features

You can change the installed features later by using REMOVE and ADDDEFAULT properties.

  1. If you want to add the the desktop shortcut later, run the following command:

msiexec /passive /i Nextcloud-x.y.z-x64.msi ADDDEFAULT="DesktopShortcut"

  1. If you want to remove it, simply run the following command:

msiexec /passive /i Nextcloud-x.y.z-x64.msi REMOVE="DesktopShortcut"

Windows keeps track of the installed features and using REMOVE or ADDDEFAULT will only affect the mentioned features.

Compare REMOVE and ADDDEFAULT on the Windows Installer Guide.

Note

You cannot specify REMOVE on initial installation as it will disable all features.

Installation Folder

You can adjust the installation folder by specifying the INSTALLDIR property like this:

msiexec /passive /i Nextcloud-x.y.z-x64.msi INSTALLDIR="C:\Program Files\Non Standard Nextcloud Client Folder"

Be careful when using PowerShell instead of cmd.exe, it can be tricky to get the whitespace escaping right there. Specifying the INSTALLDIR like this only works on first installation, you cannot simply re-invoke the .msi with a different path. If you still need to change it, uninstall it first and reinstall it with the new path.

Disabling Automatic Updates

To disable automatic updates, you can pass the SKIPAUTOUPDATE property.:

msiexec /passive /i Nextcloud-x.y.z-x64.msi SKIPAUTOUPDATE="1"

Launch After Installation

To launch the client automatically after installation, you can pass the LAUNCH property.:

msiexec /i Nextcloud-x.y.z-x64.msi LAUNCH="1"

This option also removes the checkbox to let users decide if they want to launch the client for non passive/quiet mode.

Note

This option does not have any effect without GUI.

No Reboot After Installation

The Nextcloud Client schedules a reboot after installation to make sure the Explorer extension is correctly (un)loaded. If you're taking care of the reboot yourself, you can set the REBOOT property:

msiexec /i Nextcloud-x.y.z-x64.msi REBOOT=ReallySuppress

This will make msiexec exit with error ERROR_SUCCESS_REBOOT_REQUIRED (3010). If your deployment tooling interprets this as an actual error and you want to avoid that, you may want to set the DO_NOT_SCHEDULE_REBOOT instead:

msiexec /i Nextcloud-x.y.z-x64.msi DO_NOT_SCHEDULE_REBOOT="1"

Installation Wizard

The installation wizard takes you step-by-step through configuration options and account setup. First you need to enter the URL of your Nextcloud server.

form for entering Nextcloud server URL

Enter your Nextcloud login on the next screen.

form for entering your Nextcloud login

On the Local Folder Option screen you may sync all of your files on the Nextcloud server, or select individual folders. The default local sync folder is Nextcloud, in your home directory. You may change this as well.

Select which remote folders to sync, and which local folder to store
them in.

When you have completed selecting your sync folders, click the Connect button at the bottom right. The client will attempt to connect to your Nextcloud server, and when it is successful you'll see two buttons: one to connect to your Nextcloud Web GUI, and one to open your local folder. It will also start synchronizing your files.

A successful server connection, showing a button to connect to your
Web GUI, and one to open your local Nextcloud folder

Click the Finish button, and you're all done.