| Current Path : /usr/share/doc/nextcloud-desktop/html/ |
Linux ift1.ift-informatik.de 5.4.0-216-generic #236-Ubuntu SMP Fri Apr 11 19:53:21 UTC 2025 x86_64 |
| Current File : //usr/share/doc/nextcloud-desktop/html/autoupdate.html |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>The Automatic Updater — Nextcloud Client Manual 2.4.0 documentation</title>
<link rel="stylesheet" href="_static/classic.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="_static/language_data.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Appendix A: Building the Client" href="building.html" />
<link rel="prev" title="Advanced Usage" href="advancedusage.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="building.html" title="Appendix A: Building the Client"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="advancedusage.html" title="Advanced Usage"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">Client Manual</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="the-automatic-updater">
<h1>The Automatic Updater<a class="headerlink" href="#the-automatic-updater" title="Permalink to this headline">¶</a></h1>
<p>The Automatic Updater ensures that you always have the
latest features and bug fixes for your Nextcloud synchronization client.</p>
<p>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.</p>
<div class="section" id="basic-workflow">
<h2>Basic Workflow<a class="headerlink" href="#basic-workflow" title="Permalink to this headline">¶</a></h2>
<p>The following sections describe how to use the Automatic Updater on different
operating systems.</p>
<div class="section" id="windows">
<h3>Windows<a class="headerlink" href="#windows" title="Permalink to this headline">¶</a></h3>
<p>The Nextcloud client checks for updates and downloads them when available. You
can view the update status under <code class="docutils literal notranslate"><span class="pre">Settings</span> <span class="pre">-></span> <span class="pre">General</span> <span class="pre">-></span> <span class="pre">Updates</span></code> in the
Nextcloud client.</p>
<p>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.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Administrative privileges are required to perform the update.</p>
</div>
</div>
<div class="section" id="macos">
<h3>macOS<a class="headerlink" href="#macos" title="Permalink to this headline">¶</a></h3>
<p>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.</p>
</div>
<div class="section" id="linux">
<h3>Linux<a class="headerlink" href="#linux" title="Permalink to this headline">¶</a></h3>
<p>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 (<code class="docutils literal notranslate"><span class="pre">Settings</span> <span class="pre">-></span> <span class="pre">General</span> <span class="pre">-></span> <span class="pre">Updates</span></code>) when an update is
available.</p>
</div>
</div>
<div class="section" id="preventing-automatic-updates">
<h2>Preventing Automatic Updates<a class="headerlink" href="#preventing-automatic-updates" title="Permalink to this headline">¶</a></h2>
<p>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.</p>
<div class="section" id="preventing-automatic-updates-in-windows-environments">
<h3>Preventing Automatic Updates in Windows Environments<a class="headerlink" href="#preventing-automatic-updates-in-windows-environments" title="Permalink to this headline">¶</a></h3>
<p>Users may disable automatic updates by adding this line to the [General]
section of their <code class="docutils literal notranslate"><span class="pre">nextcloud.cfg</span></code> files:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">skipUpdateCheck</span><span class="o">=</span><span class="n">true</span>
</pre></div>
</div>
<p>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.</p>
<p>To prevent automatic updates, but allow manual overrides:</p>
<ol class="arabic">
<li><p class="first">Edit these Registry keys:</p>
<blockquote>
<div><ol class="loweralpha simple">
<li>(32-bit-Windows) <code class="docutils literal notranslate"><span class="pre">HKEY_LOCAL_MACHINE\Software\Nextcloud\Nextcloud</span></code></li>
<li>(64-bit-Windows) <code class="docutils literal notranslate"><span class="pre">HKEY_LOCAL_MACHINE\Software\Wow6432Node\Nextcloud\Nextcloud</span></code></li>
</ol>
</div></blockquote>
</li>
<li><p class="first">Add the key <code class="docutils literal notranslate"><span class="pre">skipUpdateCheck</span></code> (of type DWORD).</p>
</li>
<li><p class="first">Specify a value of <code class="docutils literal notranslate"><span class="pre">1</span></code> to the machine.</p>
</li>
</ol>
<p>To manually override this key, use the same value in <code class="docutils literal notranslate"><span class="pre">HKEY_CURRENT_USER</span></code>.</p>
<p>To prevent automatic updates and disallow manual overrides:</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">This is the preferred method of controlling the updater behavior using
Group Policies.</p>
</div>
<ol class="arabic">
<li><p class="first">Edit this Registry key:</p>
<blockquote>
<div><p><code class="docutils literal notranslate"><span class="pre">HKEY_LOCAL_MACHINE\Software\Policies\Nextcloud\Nextcloud</span></code></p>
</div></blockquote>
</li>
<li><p class="first">Add the key <code class="docutils literal notranslate"><span class="pre">skipUpdateCheck</span></code> (of type DWORD).</p>
</li>
<li><p class="first">Specify a value of <code class="docutils literal notranslate"><span class="pre">1</span></code> to the machine.</p>
</li>
</ol>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">branded clients have different key names</p>
</div>
</div>
<div class="section" id="preventing-automatic-updates-in-macos-environments">
<h3>Preventing Automatic Updates in macOS Environments<a class="headerlink" href="#preventing-automatic-updates-in-macos-environments" title="Permalink to this headline">¶</a></h3>
<p>You can disable the automatic update mechanism, in the macOS operating system,
by copying the file
<code class="docutils literal notranslate"><span class="pre">nextcloud.app/Contents/Resources/deny_autoupdate_com.nextcloud.desktopclient.plist</span></code>
to <code class="docutils literal notranslate"><span class="pre">/Library/Preferences/com.nextcloud.desktopclient.plist</span></code>.</p>
</div>
<div class="section" id="preventing-automatic-updates-in-linux-environments">
<h3>Preventing Automatic Updates in Linux Environments<a class="headerlink" href="#preventing-automatic-updates-in-linux-environments" title="Permalink to this headline">¶</a></h3>
<p>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, <code class="docutils literal notranslate"><span class="pre">$HOME/.config/Nextcloud/nextcloud.cfg</span></code>.
Add this line to the [General] section:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">skipUpdateCheck</span><span class="o">=</span><span class="n">true</span>
</pre></div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">The Automatic Updater</a><ul>
<li><a class="reference internal" href="#basic-workflow">Basic Workflow</a><ul>
<li><a class="reference internal" href="#windows">Windows</a></li>
<li><a class="reference internal" href="#macos">macOS</a></li>
<li><a class="reference internal" href="#linux">Linux</a></li>
</ul>
</li>
<li><a class="reference internal" href="#preventing-automatic-updates">Preventing Automatic Updates</a><ul>
<li><a class="reference internal" href="#preventing-automatic-updates-in-windows-environments">Preventing Automatic Updates in Windows Environments</a></li>
<li><a class="reference internal" href="#preventing-automatic-updates-in-macos-environments">Preventing Automatic Updates in macOS Environments</a></li>
<li><a class="reference internal" href="#preventing-automatic-updates-in-linux-environments">Preventing Automatic Updates in Linux Environments</a></li>
</ul>
</li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="advancedusage.html"
title="previous chapter">Advanced Usage</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="building.html"
title="next chapter">Appendix A: Building the Client</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/autoupdate.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="building.html" title="Appendix A: Building the Client"
>next</a> |</li>
<li class="right" >
<a href="advancedusage.html" title="Advanced Usage"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">Client Manual</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2013-2020, The Nextcloud developers.
Last updated on Mar 24, 2020.
</div>
</body>
</html>