mirror of
https://github.com/nextcloud/desktop.git
synced 2024-12-22 21:50:30 +03:00
115 lines
4 KiB
ReStructuredText
115 lines
4 KiB
ReStructuredText
=====================
|
|
The Automatic Updater
|
|
=====================
|
|
|
|
The Automatic Updater ensures that you always have the
|
|
latest features and bug fixes for your Nextcloud synchronization client.
|
|
|
|
The Automatic Updater updates only on macOS and Windows computers; Linux
|
|
users only need to use their normal package managers. However, on Linux systems
|
|
the Updater will check for updates and notify you when a new version is
|
|
available.
|
|
|
|
Basic Workflow
|
|
--------------
|
|
|
|
The following sections describe how to use the Automatic Updater on different
|
|
operating systems.
|
|
|
|
Windows
|
|
^^^^^^^
|
|
|
|
The Nextcloud client checks for updates and downloads them when available. You
|
|
can view the update status under ``Settings -> General -> Updates`` in the
|
|
Nextcloud client.
|
|
|
|
If an update is available, and has been successfully downloaded, the Nextcloud
|
|
client starts a silent update prior to its next launch and then restarts
|
|
itself. Should the silent update fail, the client offers a manual download.
|
|
|
|
.. note:: Administrative privileges are required to perform the update.
|
|
|
|
macOS
|
|
^^^^^
|
|
|
|
If a new update is available, the Nextcloud client initializes a pop-up dialog
|
|
to alert you of the update and requesting that you update to the latest
|
|
version. Due to their use of the Sparkle frameworks, this is the default
|
|
process for macOS applications.
|
|
|
|
Linux
|
|
^^^^^
|
|
|
|
Linux distributions provide their own update tools, so Nextcloud clients that use
|
|
the Linux operating system do not perform any updates on their own. The client
|
|
will inform you (``Settings -> General -> Updates``) when an update is
|
|
available.
|
|
|
|
Preventing Automatic Updates
|
|
----------------------------
|
|
|
|
In controlled environments, such as companies or universities, you might not
|
|
want to enable the auto-update mechanism, as it interferes with controlled
|
|
deployment tools and policies. To address this case, it is possible to disable
|
|
the auto-updater entirely. The following sections describe how to disable the
|
|
auto-update mechanism for different operating systems.
|
|
|
|
Preventing Automatic Updates in Windows Environments
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Users may disable automatic updates by adding this line to the [General]
|
|
section of their ``nextcloud.cfg`` files::
|
|
|
|
skipUpdateCheck=true
|
|
|
|
Windows administrators have more options for preventing automatic updates in
|
|
Windows environments by using one of two methods. The first method allows users
|
|
to override the automatic update check mechanism, whereas the second method
|
|
prevents any manual overrides.
|
|
|
|
To prevent automatic updates, but allow manual overrides:
|
|
|
|
1. Edit these Registry keys:
|
|
|
|
a. (32-bit-Windows) ``HKEY_LOCAL_MACHINE\Software\Nextcloud\Nextcloud``
|
|
b. (64-bit-Windows) ``HKEY_LOCAL_MACHINE\Software\Wow6432Node\Nextcloud\Nextcloud``
|
|
|
|
2. Add the key ``skipUpdateCheck`` (of type DWORD).
|
|
|
|
3. Specify a value of ``1`` to the machine.
|
|
|
|
To manually override this key, use the same value in ``HKEY_CURRENT_USER``.
|
|
|
|
To prevent automatic updates and disallow manual overrides:
|
|
|
|
.. note:: This is the preferred method of controlling the updater behavior using
|
|
Group Policies.
|
|
|
|
1. Edit this Registry key:
|
|
|
|
``HKEY_LOCAL_MACHINE\Software\Policies\Nextcloud\Nextcloud``
|
|
|
|
2. Add the key ``skipUpdateCheck`` (of type DWORD).
|
|
|
|
3. Specify a value of ``1`` to the machine.
|
|
|
|
.. note:: branded clients have different key names
|
|
|
|
|
|
Preventing Automatic Updates in macOS Environments
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
You can disable the automatic update mechanism, in the macOS operating system,
|
|
by copying the file
|
|
``nextcloud.app/Contents/Resources/deny_autoupdate_com.nextcloud.desktopclient.plist``
|
|
to ``/Library/Preferences/com.nextcloud.desktopclient.plist``.
|
|
|
|
Preventing Automatic Updates in Linux Environments
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Because the Linux client does not provide automatic updating functionality, there is no
|
|
need to remove the automatic-update check. However, if you want to disable it edit your desktop
|
|
client configuration file, ``$HOME/.config/Nextcloud/nextcloud.cfg``.
|
|
Add this line to the [General] section::
|
|
|
|
skipUpdateCheck=true
|