david/therinaldos.com
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

migrate therinaldos.com data
Build & Deploy to DigitalOcean Space / build (push) Failing after 2m38s
Details

Browse Source
This commit is contained in:
david
2024-05-05 15:50:45 -04:00
commit ef1ff240d4
23182 changed files with 3801898 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
wedding-pics/core/doc/admin/issues/applying_patch.html
+232
View File
@@ -0,0 +1,232 @@
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Patching Nextcloud &mdash; Nextcloud latest Administration Manual latest documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../_static/dark_mode_css/general.css" type="text/css" />
<link rel="stylesheet" href="../_static/dark_mode_css/dark.css" type="text/css" />
<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
<script src="../_static/jquery.js?v=5d32c60e"></script>
<script src="../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
<script src="../_static/documentation_options.js?v=c6e86fd7"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/dark_mode_js/default_light.js?v=c2e647ce"></script>
<script src="../_static/dark_mode_js/theme_switcher.js?v=358d3910"></script>
<script src="../_static/js/theme.js"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Code signing" href="code_signing.html" />
<link rel="prev" title="General troubleshooting" href="general_troubleshooting.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="../contents.html">
<img src="../_static/logo-white.png" class="logo" alt="Logo"/>
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
<li class="toctree-l1"><a class="reference internal" href="../release_notes/index.html">Release notes</a></li>
<li class="toctree-l1"><a class="reference internal" href="../release_schedule.html">Maintenance and release schedule</a></li>
<li class="toctree-l1"><a class="reference internal" href="../installation/index.html">Installation and server configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_server/index.html">Nextcloud configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../apps_management.html">Apps management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_user/index.html">User management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_files/index.html">File sharing and management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../file_workflows/index.html">Flow</a></li>
<li class="toctree-l1"><a class="reference internal" href="../groupware/index.html">Groupware</a></li>
<li class="toctree-l1"><a class="reference internal" href="../office/index.html">Office</a></li>
<li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../ai/index.html">Artificial Intelligence</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_database/index.html">Database configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_mimetypes/index.html">Mimetypes management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../maintenance/index.html">Maintenance</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="index.html">Issues and troubleshooting</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html">General troubleshooting</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">Patching Nextcloud</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#applying-a-patch">Applying a patch</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#patching-server">Patching server</a></li>
<li class="toctree-l4"><a class="reference internal" href="#patching-apps">Patching apps</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#reverting-a-patch">Reverting a patch</a></li>
<li class="toctree-l3"><a class="reference internal" href="#getting-a-patch-from-a-github-pull-request">Getting a patch from a GitHub pull request</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="code_signing.html">Code signing</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../gdpr/index.html">GDPR-compliance</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../contents.html">Nextcloud latest Administration Manual</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content style-external-links">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="../contents.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item"><a href="index.html">Issues and troubleshooting</a></li>
<li class="breadcrumb-item active">Patching Nextcloud</li>
<li class="wy-breadcrumbs-aside">
<a href="https://github.com/nextcloud/documentation/edit/master/admin_manual/issues/applying_patch.rst" class="fa fa-github"> Edit on GitHub</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="patching-nextcloud">
<h1>Patching Nextcloud<a class="headerlink" href="#patching-nextcloud" title="Link to this heading"></a></h1>
<section id="applying-a-patch">
<h2>Applying a patch<a class="headerlink" href="#applying-a-patch" title="Link to this heading"></a></h2>
<section id="patching-server">
<h3>Patching server<a class="headerlink" href="#patching-server" title="Link to this heading"></a></h3>
<ol class="arabic">
<li><p>Navigate into your Nextcloud server’s root directory (contains the <code class="docutils literal notranslate"><span class="pre">status.php</span></code> file)</p></li>
<li><p>Now apply the patch with the following command:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">patch</span> <span class="o">-</span><span class="n">p</span> <span class="mi">1</span> <span class="o">&lt;</span> <span class="o">/</span><span class="n">path</span><span class="o">/</span><span class="n">to</span><span class="o">/</span><span class="n">the</span><span class="o">/</span><span class="n">file</span><span class="o">.</span><span class="n">patch</span>
</pre></div>
</div>
</li>
</ol>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>There can be errors about not found files, especially when you take a patch from GitHub there might be development or test files included in the patch. when the files are in build/ or a tests/ subdirectory it is mostly being</p>
</div>
</section>
<section id="patching-apps">
<h3>Patching apps<a class="headerlink" href="#patching-apps" title="Link to this heading"></a></h3>
<ol class="arabic simple">
<li><p>Navigate to the root of this app (mostly <code class="docutils literal notranslate"><span class="pre">apps/[APPID]/</span></code>), if you can not find the app there use the <code class="docutils literal notranslate"><span class="pre">sudo</span> <span class="pre">-u</span> <span class="pre">www-data</span> <span class="pre">php</span> <span class="pre">occ</span> <span class="pre">app:getpath</span> <span class="pre">APPID</span></code> command to find the path.</p></li>
<li><p>Now apply the patch with the same command as in <a class="reference internal" href="#patching-server">Patching server</a></p></li>
</ol>
</section>
</section>
<section id="reverting-a-patch">
<h2>Reverting a patch<a class="headerlink" href="#reverting-a-patch" title="Link to this heading"></a></h2>
<ol class="arabic">
<li><p>Navigate to the directory where you applied the patch.</p></li>
<li><p>Now revert the patch with the <code class="docutils literal notranslate"><span class="pre">-R</span></code> option:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">patch</span> <span class="o">-</span><span class="n">R</span> <span class="o">-</span><span class="n">p</span> <span class="mi">1</span> <span class="o">&lt;</span> <span class="o">/</span><span class="n">path</span><span class="o">/</span><span class="n">to</span><span class="o">/</span><span class="n">the</span><span class="o">/</span><span class="n">file</span><span class="o">.</span><span class="n">patch</span>
</pre></div>
</div>
</li>
</ol>
</section>
<section id="getting-a-patch-from-a-github-pull-request">
<h2>Getting a patch from a GitHub pull request<a class="headerlink" href="#getting-a-patch-from-a-github-pull-request" title="Link to this heading"></a></h2>
<p>If you found a related pull request on GitHub that solves your issue, or you want to help developers and verify a fix works, you can get a patch for the pull request.</p>
<ol class="arabic simple">
<li><p>Using <a class="reference external" href="https://github.com/nextcloud/server/pull/26396">https://github.com/nextcloud/server/pull/26396</a> as an example.</p></li>
<li><p>Append <code class="docutils literal notranslate"><span class="pre">.patch</span></code> to the URL: <a class="reference external" href="https://github.com/nextcloud/server/pull/26396.patch">https://github.com/nextcloud/server/pull/26396.patch</a></p></li>
<li><p>Download the patch to your server and follow the <a class="reference internal" href="#applying-a-patch">Applying a patch</a> steps.</p></li>
<li><p>In case you are on an older version, you might first need to go the the correct version of the patch.</p></li>
</ol>
<img alt="backportbot-nextcloud linking to the pull request for an older version." src="../_images/getting-a-patch-from-github.png" />
<ol class="arabic simple" start="5">
<li><p>You can find it by looking for a link by the <code class="docutils literal notranslate"><span class="pre">backportbot-nextcloud</span></code> or a developer will leave a manual comment about the backport to an older Nextcloud version. For the example above you the pull request for Nextcloud 21 is at <a class="reference external" href="https://github.com/nextcloud/server/pull/26406">https://github.com/nextcloud/server/pull/26406</a> and the patch at <a class="reference external" href="https://github.com/nextcloud/server/pull/26406.patch">https://github.com/nextcloud/server/pull/26406.patch</a></p></li>
</ol>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="general_troubleshooting.html" class="btn btn-neutral float-left" title="General troubleshooting" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="code_signing.html" class="btn btn-neutral float-right" title="Code signing" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; Copyright 2024 Nextcloud GmbH.</p>
</div>
</footer>
</div>
</div>
</section>
</div>
<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="Versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> Read the Docs</span>
v: latest
<span class="fa fa-caret-down"></span>
</span>
<div class="rst-other-versions">
<dl>
<dt>Versions</dt>
<dd><a href="https://docs.nextcloud.com/server/25/admin_manual">25</a></dd>
<dd><a href="https://docs.nextcloud.com/server/26/admin_manual">26</a></dd>
<dd><a href="https://docs.nextcloud.com/server/27/admin_manual">27</a></dd>
<dd><a href="https://docs.nextcloud.com/server/stable/admin_manual">stable</a></dd>
<dd><a href="https://docs.nextcloud.com/server/latest/admin_manual">latest</a></dd>
</dl>
<dl>
<dt>Downloads</dt>
</dl>
<dl>
<dt>On Read the Docs</dt>
<dd>
<a href="///projects//?fromdocs=">Project Home</a>
</dd>
<dd>
<a href="///builds//?fromdocs=">Builds</a>
</dd>
</dl>
</div>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>
wedding-pics/core/doc/admin/issues/code_signing.html
+408
View File
@@ -0,0 +1,408 @@
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Code signing &mdash; Nextcloud latest Administration Manual latest documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../_static/dark_mode_css/general.css" type="text/css" />
<link rel="stylesheet" href="../_static/dark_mode_css/dark.css" type="text/css" />
<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
<script src="../_static/jquery.js?v=5d32c60e"></script>
<script src="../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
<script src="../_static/documentation_options.js?v=c6e86fd7"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/dark_mode_js/default_light.js?v=c2e647ce"></script>
<script src="../_static/dark_mode_js/theme_switcher.js?v=358d3910"></script>
<script src="../_static/js/theme.js"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="GDPR-compliance" href="../gdpr/index.html" />
<link rel="prev" title="Patching Nextcloud" href="applying_patch.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="../contents.html">
<img src="../_static/logo-white.png" class="logo" alt="Logo"/>
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
<li class="toctree-l1"><a class="reference internal" href="../release_notes/index.html">Release notes</a></li>
<li class="toctree-l1"><a class="reference internal" href="../release_schedule.html">Maintenance and release schedule</a></li>
<li class="toctree-l1"><a class="reference internal" href="../installation/index.html">Installation and server configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_server/index.html">Nextcloud configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../apps_management.html">Apps management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_user/index.html">User management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_files/index.html">File sharing and management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../file_workflows/index.html">Flow</a></li>
<li class="toctree-l1"><a class="reference internal" href="../groupware/index.html">Groupware</a></li>
<li class="toctree-l1"><a class="reference internal" href="../office/index.html">Office</a></li>
<li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../ai/index.html">Artificial Intelligence</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_database/index.html">Database configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_mimetypes/index.html">Mimetypes management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../maintenance/index.html">Maintenance</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="index.html">Issues and troubleshooting</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html">General troubleshooting</a></li>
<li class="toctree-l2"><a class="reference internal" href="applying_patch.html">Patching Nextcloud</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">Code signing</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#faq">FAQ</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#why-did-nextcloud-add-code-signing">Why did Nextcloud add code signing?</a></li>
<li class="toctree-l4"><a class="reference internal" href="#do-we-lock-down-nextcloud">Do we lock down Nextcloud?</a></li>
<li class="toctree-l4"><a class="reference internal" href="#not-open-source-anymore">Not open source anymore?</a></li>
<li class="toctree-l4"><a class="reference internal" href="#is-code-signing-mandatory-for-apps">Is code signing mandatory for apps?</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#fixing-invalid-code-integrity-messages">Fixing invalid code integrity messages</a></li>
<li class="toctree-l3"><a class="reference internal" href="#rescans">Rescans</a></li>
<li class="toctree-l3"><a class="reference internal" href="#errors">Errors</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../gdpr/index.html">GDPR-compliance</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../contents.html">Nextcloud latest Administration Manual</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content style-external-links">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="../contents.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item"><a href="index.html">Issues and troubleshooting</a></li>
<li class="breadcrumb-item active">Code signing</li>
<li class="wy-breadcrumbs-aside">
<a href="https://github.com/nextcloud/documentation/edit/master/admin_manual/issues/code_signing.rst" class="fa fa-github"> Edit on GitHub</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="code-signing">
<h1>Code signing<a class="headerlink" href="#code-signing" title="Link to this heading"></a></h1>
<p id="code-signing-label">Nextcloud supports code signing for the core releases, and for Nextcloud
applications. Code signing gives our users an additional layer of security by
ensuring that nobody other than authorized persons can push updates.</p>
<p>It also ensures that all upgrades have been executed properly, so that no files
are left behind, and all old files are properly replaced. In the past, invalid
updates were a significant source of errors when updating Nextcloud.</p>
<section id="faq">
<h2>FAQ<a class="headerlink" href="#faq" title="Link to this heading"></a></h2>
<section id="why-did-nextcloud-add-code-signing">
<h3>Why did Nextcloud add code signing?<a class="headerlink" href="#why-did-nextcloud-add-code-signing" title="Link to this heading"></a></h3>
<p>By supporting Code Signing we add another layer of security by ensuring that
nobody other than authorized persons can push updates for applications, and
ensuring proper upgrades.</p>
</section>
<section id="do-we-lock-down-nextcloud">
<h3>Do we lock down Nextcloud?<a class="headerlink" href="#do-we-lock-down-nextcloud" title="Link to this heading"></a></h3>
<p>The Nextcloud project is open source and always will be. We do not want to
make it more difficult for our users to run Nextcloud. Any code signing errors on
upgrades will not prevent Nextcloud from running, but will display a warning on
the Admin page. For applications that are not tagged “Official” the code signing
process is optional.</p>
</section>
<section id="not-open-source-anymore">
<h3>Not open source anymore?<a class="headerlink" href="#not-open-source-anymore" title="Link to this heading"></a></h3>
<p>The Nextcloud project is open source and always will be. The code signing
process is optional, though highly recommended. The code check for the
core parts of Nextcloud is enabled when the Nextcloud release version branch has
been set to stable.</p>
<p>For custom distributions of Nextcloud it is recommended to change the release
version branch in version.php to something else than “stable”.</p>
</section>
<section id="is-code-signing-mandatory-for-apps">
<h3>Is code signing mandatory for apps?<a class="headerlink" href="#is-code-signing-mandatory-for-apps" title="Link to this heading"></a></h3>
<p>Code signing is required for all applications on apps.nextcloud.com.</p>
</section>
</section>
<section id="fixing-invalid-code-integrity-messages">
<span id="code-signing-fix-warning-label"></span><h2>Fixing invalid code integrity messages<a class="headerlink" href="#fixing-invalid-code-integrity-messages" title="Link to this heading"></a></h2>
<p>A code integrity error message (“Some files have not passed the integrity check…”) appears on your Nextcloud admin page under “Overview”, which provides
the following options:</p>
<ol class="arabic simple">
<li><p>Link to this documentation entry.</p></li>
<li><p>Show a list of invalid files.</p></li>
<li><p>Trigger a rescan.</p></li>
</ol>
<img alt="Links for resolving code integrity warnings." src="../_images/code-integrity-admin.png" />
<p>To debug issues caused by the code integrity check click on “List of invalid
files…”, and you will be shown a text document listing the different issues. The
content of the file will look similar to the following example:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">Technical</span> <span class="n">information</span>
<span class="o">=====================</span>
<span class="n">The</span> <span class="n">following</span> <span class="nb">list</span> <span class="n">covers</span> <span class="n">which</span> <span class="n">files</span> <span class="n">have</span> <span class="n">failed</span> <span class="n">the</span> <span class="n">integrity</span> <span class="n">check</span><span class="o">.</span> <span class="n">Please</span> <span class="n">read</span>
<span class="n">the</span> <span class="n">previous</span> <span class="n">linked</span> <span class="n">documentation</span> <span class="n">to</span> <span class="n">learn</span> <span class="n">more</span> <span class="n">about</span> <span class="n">the</span> <span class="n">errors</span> <span class="ow">and</span> <span class="n">how</span> <span class="n">to</span> <span class="n">fix</span>
<span class="n">them</span><span class="o">.</span>
<span class="n">Results</span>
<span class="o">=======</span>
<span class="o">-</span> <span class="n">core</span>
<span class="o">-</span> <span class="n">INVALID_HASH</span>
<span class="o">-</span> <span class="o">/</span><span class="n">index</span><span class="o">.</span><span class="n">php</span>
<span class="o">-</span> <span class="o">/</span><span class="n">version</span><span class="o">.</span><span class="n">php</span>
<span class="o">-</span> <span class="n">EXTRA_FILE</span>
<span class="o">-</span> <span class="o">/</span><span class="n">test</span><span class="o">.</span><span class="n">php</span>
<span class="o">-</span> <span class="n">calendar</span>
<span class="o">-</span> <span class="n">EXCEPTION</span>
<span class="o">-</span> <span class="n">OC</span>\<span class="n">IntegrityCheck</span>\<span class="n">Exceptions</span>\<span class="n">InvalidSignatureException</span>
<span class="o">-</span> <span class="n">Signature</span> <span class="n">data</span> <span class="ow">not</span> <span class="n">found</span><span class="o">.</span>
<span class="n">Raw</span> <span class="n">output</span>
<span class="o">==========</span>
<span class="n">Array</span>
<span class="p">(</span>
<span class="p">[</span><span class="n">core</span><span class="p">]</span> <span class="o">=&gt;</span> <span class="n">Array</span>
<span class="p">(</span>
<span class="p">[</span><span class="n">INVALID_HASH</span><span class="p">]</span> <span class="o">=&gt;</span> <span class="n">Array</span>
<span class="p">(</span>
<span class="p">[</span><span class="o">/</span><span class="n">index</span><span class="o">.</span><span class="n">php</span><span class="p">]</span> <span class="o">=&gt;</span> <span class="n">Array</span>
<span class="p">(</span>
<span class="p">[</span><span class="n">expected</span><span class="p">]</span> <span class="o">=&gt;</span>
<span class="n">f1c5e2630d784bc9cb02d5a28f55d6f24d06dae2a0fee685f3</span>
<span class="n">c2521b050955d9d452769f61454c9ddfa9c308146ade10546c</span>
<span class="n">fa829794448eaffbc9a04a29d216</span>
<span class="p">[</span><span class="n">current</span><span class="p">]</span> <span class="o">=&gt;</span>
<span class="n">ce08bf30bcbb879a18b49239a9bec6b8702f52452f88a9d321</span>
<span class="mi">42</span><span class="n">cad8d2494d5735e6bfa0d8642b2762c62ca5be49f9bf4ec2</span>
<span class="mi">31</span><span class="n">d4a230559d4f3e2c471d3ea094</span>
<span class="p">)</span>
<span class="p">[</span><span class="o">/</span><span class="n">version</span><span class="o">.</span><span class="n">php</span><span class="p">]</span> <span class="o">=&gt;</span> <span class="n">Array</span>
<span class="p">(</span>
<span class="p">[</span><span class="n">expected</span><span class="p">]</span> <span class="o">=&gt;</span>
<span class="n">c5a03bacae8dedf8b239997901ba1fffd2fe51271d13a00cc4</span>
<span class="n">b34b09cca5176397a89fc27381cbb1f72855fa18b69b6f87d7</span>
<span class="n">d5685c3b45aee373b09be54742ea</span>
<span class="p">[</span><span class="n">current</span><span class="p">]</span> <span class="o">=&gt;</span>
<span class="mi">88</span><span class="n">a3a92c11db91dec1ac3be0e1c87f862c95ba6ffaaaa3f2c3</span>
<span class="n">b8f682187c66f07af3a3b557a868342ef4a271218fe1c1e300</span>
<span class="n">c478e6c156c5955ed53c40d06585</span>
<span class="p">)</span>
<span class="p">)</span>
<span class="p">[</span><span class="n">EXTRA_FILE</span><span class="p">]</span> <span class="o">=&gt;</span> <span class="n">Array</span>
<span class="p">(</span>
<span class="p">[</span><span class="o">/</span><span class="n">test</span><span class="o">.</span><span class="n">php</span><span class="p">]</span> <span class="o">=&gt;</span> <span class="n">Array</span>
<span class="p">(</span>
<span class="p">[</span><span class="n">expected</span><span class="p">]</span> <span class="o">=&gt;</span>
<span class="p">[</span><span class="n">current</span><span class="p">]</span> <span class="o">=&gt;</span>
<span class="mi">09563164</span><span class="n">f9904a837f9ca0b5f626db56c838e5098e0ccc1d8b</span>
<span class="mi">935</span><span class="n">f68fa03a25c5ec6f6b2d9e44a868e8b85764dafd1605522</span>
<span class="n">b4af8db0ae269d73432e9a01e63a</span>
<span class="p">)</span>
<span class="p">)</span>
<span class="p">)</span>
<span class="p">[</span><span class="n">calendar</span><span class="p">]</span> <span class="o">=&gt;</span> <span class="n">Array</span>
<span class="p">(</span>
<span class="p">[</span><span class="n">EXCEPTION</span><span class="p">]</span> <span class="o">=&gt;</span> <span class="n">Array</span>
<span class="p">(</span>
<span class="p">[</span><span class="n">class</span><span class="p">]</span> <span class="o">=&gt;</span> <span class="n">OC</span>\<span class="n">IntegrityCheck</span>\<span class="n">Exceptions</span>\<span class="n">InvalidSignature</span>
<span class="ne">Exception</span>
<span class="p">[</span><span class="n">message</span><span class="p">]</span> <span class="o">=&gt;</span> <span class="n">Signature</span> <span class="n">data</span> <span class="ow">not</span> <span class="n">found</span><span class="o">.</span>
<span class="p">)</span>
<span class="p">)</span>
<span class="p">)</span>
</pre></div>
</div>
<p>In above error output it can be seen that:</p>
<ol class="arabic simple">
<li><p>In the Nextcloud core (that is, the Nextcloud server itself) the files
“index.php” and “version.php” do have the wrong version.</p></li>
<li><p>In the Nextcloud core the unrequired extra file “/test.php” has been found.</p></li>
<li><p>It was not possible to verify the signature of the calendar application.</p></li>
</ol>
<p>The solution is to upload the correct “index.php” and “version.php” files, and
delete the “test.php” file. For the calendar exception contact the developer of
the application. For other means on how to receive support please take a look at
<a class="reference external" href="https://nextcloud.com/support/">https://nextcloud.com/support/</a>. After fixing these problems verify by clicking
“Rescan…”.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>When using a FTP client to upload those files make sure it is using the
<code class="docutils literal notranslate"><span class="pre">Binary</span></code> transfer mode instead of the <code class="docutils literal notranslate"><span class="pre">ASCII</span></code> transfer mode.</p>
</div>
</section>
<section id="rescans">
<span id="rescans-label"></span><h2>Rescans<a class="headerlink" href="#rescans" title="Link to this heading"></a></h2>
<p>Rescans are triggered at installation, and by updates. You may run scans manually with the <code class="docutils literal notranslate"><span class="pre">occ</span></code> command. The first command scans the Nextcloud server files, and the second command scans the named app. There is not yet a command to manually scan all apps:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>occ integrity:check-core
occ integrity:check-app $appid
</pre></div>
</div>
<p>See <a class="reference internal" href="../configuration_server/occ_command.html"><span class="doc">Using the occ command</span></a> to learn more about using <code class="docutils literal notranslate"><span class="pre">occ</span></code>.</p>
</section>
<section id="errors">
<h2>Errors<a class="headerlink" href="#errors" title="Link to this heading"></a></h2>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<p>Please don’t modify the mentioned <code class="docutils literal notranslate"><span class="pre">signature.json</span></code> itself.</p>
</div>
<p>The following errors can be encountered when trying to verify a code signature.</p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">INVALID_HASH</span></code></p>
<ul>
<li><p>The file has a different hash than specified within <code class="docutils literal notranslate"><span class="pre">signature.json</span></code>. This
usually happens when the file has been modified after writing the signature
data.</p></li>
</ul>
</li>
<li><p><code class="docutils literal notranslate"><span class="pre">MISSING_FILE</span></code></p>
<ul>
<li><p>The file cannot be found but has been specified within <code class="docutils literal notranslate"><span class="pre">signature.json</span></code>.
Either a required file has been left out, or <code class="docutils literal notranslate"><span class="pre">signature.json</span></code> needs to be
edited.</p></li>
</ul>
</li>
<li><p><code class="docutils literal notranslate"><span class="pre">EXTRA_FILE</span></code></p>
<ul>
<li><p>The file does not exist in <code class="docutils literal notranslate"><span class="pre">signature.json</span></code>. This usually happens when a
file has been removed and <code class="docutils literal notranslate"><span class="pre">signature.json</span></code> has not been updated. It also
happens if you have placed additional files in your Nextcloud installation
folder.</p></li>
</ul>
</li>
<li><p><code class="docutils literal notranslate"><span class="pre">EXCEPTION</span></code></p>
<ul>
<li><p>Another exception has prevented the code verification. There are currently
these following exceptions:</p>
<ul>
<li><p><code class="docutils literal notranslate"><span class="pre">Signature</span> <span class="pre">data</span> <span class="pre">not</span> <span class="pre">found.</span></code></p>
<ul>
<li><p>The app has mandatory code signing enforced but no <code class="docutils literal notranslate"><span class="pre">signature.json</span></code>
file has been found in its <code class="docutils literal notranslate"><span class="pre">appinfo</span></code> folder.</p></li>
</ul>
</li>
<li><p><code class="docutils literal notranslate"><span class="pre">Certificate</span> <span class="pre">is</span> <span class="pre">not</span> <span class="pre">valid.</span></code></p>
<ul>
<li><p>The certificate has not been issued by the official Nextcloud Code
Signing Root Authority.</p></li>
</ul>
</li>
<li><p><code class="docutils literal notranslate"><span class="pre">Certificate</span> <span class="pre">is</span> <span class="pre">not</span> <span class="pre">valid</span> <span class="pre">for</span> <span class="pre">required</span> <span class="pre">scope.</span> <span class="pre">(Requested:</span> <span class="pre">%s,</span> <span class="pre">current:</span> <span class="pre">%s)</span></code></p>
<ul>
<li><p>The certificate is not valid for the defined application. Certificates
are only valid for the defined app identifier and cannot be used for
others.</p></li>
</ul>
</li>
<li><p><code class="docutils literal notranslate"><span class="pre">Signature</span> <span class="pre">could</span> <span class="pre">not</span> <span class="pre">get</span> <span class="pre">verified.</span></code></p>
<ul>
<li><p>There was a problem with verifying the signature of <code class="docutils literal notranslate"><span class="pre">signature.json</span></code>.</p></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="applying_patch.html" class="btn btn-neutral float-left" title="Patching Nextcloud" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="../gdpr/index.html" class="btn btn-neutral float-right" title="GDPR-compliance" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; Copyright 2024 Nextcloud GmbH.</p>
</div>
</footer>
</div>
</div>
</section>
</div>
<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="Versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> Read the Docs</span>
v: latest
<span class="fa fa-caret-down"></span>
</span>
<div class="rst-other-versions">
<dl>
<dt>Versions</dt>
<dd><a href="https://docs.nextcloud.com/server/25/admin_manual">25</a></dd>
<dd><a href="https://docs.nextcloud.com/server/26/admin_manual">26</a></dd>
<dd><a href="https://docs.nextcloud.com/server/27/admin_manual">27</a></dd>
<dd><a href="https://docs.nextcloud.com/server/stable/admin_manual">stable</a></dd>
<dd><a href="https://docs.nextcloud.com/server/latest/admin_manual">latest</a></dd>
</dl>
<dl>
<dt>Downloads</dt>
</dl>
<dl>
<dt>On Read the Docs</dt>
<dd>
<a href="///projects//?fromdocs=">Project Home</a>
</dd>
<dd>
<a href="///builds//?fromdocs=">Builds</a>
</dd>
</dl>
</div>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>
wedding-pics/core/doc/admin/issues/general_troubleshooting.html
+651
View File
@@ -0,0 +1,651 @@
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>General troubleshooting &mdash; Nextcloud latest Administration Manual latest documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../_static/dark_mode_css/general.css" type="text/css" />
<link rel="stylesheet" href="../_static/dark_mode_css/dark.css" type="text/css" />
<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
<script src="../_static/jquery.js?v=5d32c60e"></script>
<script src="../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
<script src="../_static/documentation_options.js?v=c6e86fd7"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/dark_mode_js/default_light.js?v=c2e647ce"></script>
<script src="../_static/dark_mode_js/theme_switcher.js?v=358d3910"></script>
<script src="../_static/js/theme.js"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Patching Nextcloud" href="applying_patch.html" />
<link rel="prev" title="Issues and troubleshooting" href="index.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="../contents.html">
<img src="../_static/logo-white.png" class="logo" alt="Logo"/>
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
<li class="toctree-l1"><a class="reference internal" href="../release_notes/index.html">Release notes</a></li>
<li class="toctree-l1"><a class="reference internal" href="../release_schedule.html">Maintenance and release schedule</a></li>
<li class="toctree-l1"><a class="reference internal" href="../installation/index.html">Installation and server configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_server/index.html">Nextcloud configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../apps_management.html">Apps management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_user/index.html">User management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_files/index.html">File sharing and management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../file_workflows/index.html">Flow</a></li>
<li class="toctree-l1"><a class="reference internal" href="../groupware/index.html">Groupware</a></li>
<li class="toctree-l1"><a class="reference internal" href="../office/index.html">Office</a></li>
<li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../ai/index.html">Artificial Intelligence</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_database/index.html">Database configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_mimetypes/index.html">Mimetypes management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../maintenance/index.html">Maintenance</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="index.html">Issues and troubleshooting</a><ul class="current">
<li class="toctree-l2 current"><a class="current reference internal" href="#">General troubleshooting</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#bugs">Bugs</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id1">General troubleshooting</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#disable-3rdparty-non-shipped-apps">Disable 3rdparty / non-shipped apps</a></li>
<li class="toctree-l4"><a class="reference internal" href="#nextcloud-logfiles">Nextcloud logfiles</a></li>
<li class="toctree-l4"><a class="reference internal" href="#php-version-and-information">PHP version and information</a></li>
<li class="toctree-l4"><a class="reference internal" href="#debugging-sync-issues">Debugging sync issues</a></li>
<li class="toctree-l4"><a class="reference internal" href="#common-problems-error-messages">Common problems / error messages</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#troubleshooting-web-server-and-php-problems">Troubleshooting Web server and PHP problems</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#logfiles">Logfiles</a></li>
<li class="toctree-l4"><a class="reference internal" href="#web-server-and-php-modules">Web server and PHP modules</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#troubleshooting-webdav">Troubleshooting WebDAV</a></li>
<li class="toctree-l3"><a class="reference internal" href="#service-discovery">Service discovery</a></li>
<li class="toctree-l3"><a class="reference internal" href="#troubleshooting-sharing">Troubleshooting sharing</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#users-federated-cloud-ids-not-updated-after-a-domain-name-change">Users’ Federated Cloud IDs not updated after a domain name change</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#troubleshooting-file-encoding-on-external-storages">Troubleshooting file encoding on external storages</a></li>
<li class="toctree-l3"><a class="reference internal" href="#troubleshooting-contacts-calendar">Troubleshooting contacts &amp; calendar</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#unable-to-update-contacts-or-events">Unable to update contacts or events</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#troubleshooting-data-directory">Troubleshooting data-directory</a></li>
<li class="toctree-l3"><a class="reference internal" href="#troubleshooting-quota-or-size-issues">Troubleshooting quota or size issues</a></li>
<li class="toctree-l3"><a class="reference internal" href="#troubleshooting-downloading-or-decrypting-files">Troubleshooting downloading or decrypting files</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#bad-signature-error">Bad signature error</a></li>
<li class="toctree-l4"><a class="reference internal" href="#encryption-key-cannot-be-found">Encryption key cannot be found</a></li>
<li class="toctree-l4"><a class="reference internal" href="#encryption-key-cannot-be-found-with-external-storage-or-group-folders">Encryption key cannot be found with external storage or group folders</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#fair-use-policy">Fair Use Policy</a></li>
<li class="toctree-l3"><a class="reference internal" href="#other-issues">Other issues</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="applying_patch.html">Patching Nextcloud</a></li>
<li class="toctree-l2"><a class="reference internal" href="code_signing.html">Code signing</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../gdpr/index.html">GDPR-compliance</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../contents.html">Nextcloud latest Administration Manual</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content style-external-links">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="../contents.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item"><a href="index.html">Issues and troubleshooting</a></li>
<li class="breadcrumb-item active">General troubleshooting</li>
<li class="wy-breadcrumbs-aside">
<a href="https://github.com/nextcloud/documentation/edit/master/admin_manual/issues/general_troubleshooting.rst" class="fa fa-github"> Edit on GitHub</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="general-troubleshooting">
<h1>General troubleshooting<a class="headerlink" href="#general-troubleshooting" title="Link to this heading"></a></h1>
<p>If you have trouble installing, configuring or maintaining Nextcloud, please
refer to our community support channels:</p>
<ul class="simple">
<li><dl class="simple">
<dt><a class="reference external" href="https://help.nextcloud.com">The Nextcloud Forums</a></dt><dd><p>The Nextcloud forums have a <a class="reference external" href="https://help.nextcloud.com/t/how-to-faq-wiki">FAQ page</a> where each topic corresponds
to typical mistakes or frequently occurring issues</p>
</dd>
</dl>
</li>
</ul>
<p>Please understand that all these channels essentially consist of users like you
helping each other out. Consider helping others out where you can, to contribute
back for the help you get. This is the only way to keep a community like
Nextcloud healthy and sustainable!</p>
<p>If you are using Nextcloud in a business or otherwise large scale deployment,
note that Nextcloud GmbH offers commercial support options.</p>
<section id="bugs">
<h2>Bugs<a class="headerlink" href="#bugs" title="Link to this heading"></a></h2>
<p>If you think you have found a bug in Nextcloud, please:</p>
<ul class="simple">
<li><p>Search for a solution (see the options above)</p></li>
<li><p>Double-check your configuration</p></li>
</ul>
<p>If you can’t find a solution, please use our <a class="reference external" href="https://docs.nextcloud.com/server/latest/developer_manual/prologue/bugtracker/index.html">bugtracker</a>. You can generate a
configuration report with the <a class="reference internal" href="../configuration_server/occ_command.html#config-commands-label"><span class="std std-ref">occ config command</span></a>, with passwords automatically obscured.</p>
</section>
<section id="id1">
<h2>General troubleshooting<a class="headerlink" href="#id1" title="Link to this heading"></a></h2>
<p>Check the Nextcloud <a class="reference internal" href="../installation/system_requirements.html"><span class="doc">System requirements</span></a>, especially
supported browser versions.</p>
<p>When you see warnings about <code class="docutils literal notranslate"><span class="pre">code</span> <span class="pre">integrity</span></code>, refer to <a class="reference internal" href="code_signing.html"><span class="doc">Code signing</span></a>.</p>
<section id="disable-3rdparty-non-shipped-apps">
<h3>Disable 3rdparty / non-shipped apps<a class="headerlink" href="#disable-3rdparty-non-shipped-apps" title="Link to this heading"></a></h3>
<p>It might be possible that 3rd party / non-shipped apps are causing various
different issues. Always disable 3rd party apps before upgrades, and for
troubleshooting. Please refer to the <a class="reference internal" href="../configuration_server/occ_command.html#apps-commands-label"><span class="std std-ref">Apps commands</span></a> on how
to disable an app from command line.</p>
</section>
<section id="nextcloud-logfiles">
<h3>Nextcloud logfiles<a class="headerlink" href="#nextcloud-logfiles" title="Link to this heading"></a></h3>
<p>In a standard Nextcloud installation the log level is set to <code class="docutils literal notranslate"><span class="pre">Normal</span></code>. To find
any issues you need to raise the log level to <code class="docutils literal notranslate"><span class="pre">All</span></code> in your <code class="docutils literal notranslate"><span class="pre">config.php</span></code>
file, or to <strong>Everything</strong> on your Nextcloud Admin page. Please see
<a class="reference internal" href="../configuration_server/logging_configuration.html"><span class="doc">Logging</span></a> for more information on
these log levels.</p>
<p>Some logging - for example JavaScript console logging - needs debugging
enabled. Edit <code class="file docutils literal notranslate"><span class="pre">config/config.php</span></code> and change <code class="docutils literal notranslate"><span class="pre">'debug'</span> <span class="pre">=&gt;</span> <span class="pre">false,</span></code> to
<code class="docutils literal notranslate"><span class="pre">'debug'</span> <span class="pre">=&gt;</span> <span class="pre">true,</span></code> Be sure to change it back when you are finished.</p>
<p>For JavaScript issues you will also need to view the javascript console. All
major browsers have developer tools for viewing the console, and you
usually access them by pressing F12.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>The logfile of Nextcloud is located in the data directory
<code class="docutils literal notranslate"><span class="pre">nextcloud/data/nextcloud.log</span></code>.</p>
</div>
</section>
<section id="php-version-and-information">
<span id="label-phpinfo"></span><h3>PHP version and information<a class="headerlink" href="#php-version-and-information" title="Link to this heading"></a></h3>
<p>You will need to know the PHP version and configuration that is in-use on your
Nextcloud server. This will not necessarily be the same version and configuration as
can be reached from the command-line. The simplest way to gather this information is
by using what’s commonly referenced as <code class="docutils literal notranslate"><span class="pre">phpinfo()</span></code>.</p>
<p>The most accurate - and easiest - way to access <code class="docutils literal notranslate"><span class="pre">phpinfo</span></code> is by checking it from
within Nextcloud itself. Of course, this requires that Nextcloud is functioning
enough that you can log in as an administrator and access the
<strong>Administration settings -&gt; System</strong> menu. If so, you can enable the exposure of
<code class="docutils literal notranslate"><span class="pre">phpinfo</span></code> data by toggling it on via <code class="docutils literal notranslate"><span class="pre">occ</span></code>:</p>
<p><code class="docutils literal notranslate"><span class="pre">./occ</span> <span class="pre">config:app:set</span> <span class="pre">--value=yes</span> <span class="pre">serverinfo</span> <span class="pre">phpinfo</span></code></p>
<p>From then on a new button labeled <strong>Show phpinfo</strong> will be visible in the web
interface under <strong>Administration settings -&gt; System</strong>. Clicking it will expose
just about everything you may want to know about your PHP environment.</p>
<p>If accessing the Nextcloud web interface is not an option, you may create a
plain-text file named <strong>phpinfo.php</strong> and place it in your Web root, for
example <code class="docutils literal notranslate"><span class="pre">/var/www/html/phpinfo.php</span></code>. (Your Web root may be in a different
location; your Linux distribution documentation will tell you where.) This file
contains just this line:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>&lt;?php phpinfo(); ?&gt;
</pre></div>
</div>
<p>Open this file in a Web browser by pointing your browser to
<code class="docutils literal notranslate"><span class="pre">localhost/phpinfo.php</span></code>:</p>
<figure class="align-default">
<img alt="../_images/phpinfo.png" src="../_images/phpinfo.png" />
</figure>
<p>Your PHP version is at the top, and the rest of the page contains abundant
system information such as active modules, active <code class="docutils literal notranslate"><span class="pre">.ini</span></code> files, and much more.
When you are finished reviewing your information you must delete
<code class="docutils literal notranslate"><span class="pre">phpinfo.php</span></code>, or move it outside of your Web directory, because it is a
security risk to expose such sensitive data.</p>
</section>
<section id="debugging-sync-issues">
<h3>Debugging sync issues<a class="headerlink" href="#debugging-sync-issues" title="Link to this heading"></a></h3>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<p>The data directory on the server is exclusive to Nextcloud and must
not be modified manually.</p>
</div>
<p>Disregarding this can lead to unwanted behaviors like:</p>
<ul class="simple">
<li><p>Problems with sync clients</p></li>
<li><p>Undetected changes due to caching in the database</p></li>
</ul>
<p>If you need to directly upload files from the same server please use a WebDAV
command line client like <code class="docutils literal notranslate"><span class="pre">cadaver</span></code> to upload files to the WebDAV interface at:</p>
<p><code class="docutils literal notranslate"><span class="pre">https://example.com/nextcloud/remote.php/dav</span></code></p>
</section>
<section id="common-problems-error-messages">
<h3>Common problems / error messages<a class="headerlink" href="#common-problems-error-messages" title="Link to this heading"></a></h3>
<p>Some common problems / error messages found in your logfiles as described above:</p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">SQLSTATE[HY000]</span> <span class="pre">[1040]</span> <span class="pre">Too</span> <span class="pre">many</span> <span class="pre">connections</span></code> -&gt; You need to increase the
connection limit of your database, please refer to the manual of your database
for more information.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">SQLSTATE[HY000]:</span> <span class="pre">General</span> <span class="pre">error:</span> <span class="pre">5</span> <span class="pre">database</span> <span class="pre">is</span> <span class="pre">locked</span></code> -&gt; You’re using
<code class="docutils literal notranslate"><span class="pre">SQLite</span></code>
which can’t handle a lot of parallel requests. Please consider converting to
another database like described in
<a class="reference internal" href="../configuration_database/db_conversion.html"><span class="doc">Converting database type</span></a>.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">SQLSTATE[HY000]:</span> <span class="pre">General</span> <span class="pre">error:</span> <span class="pre">2006</span> <span class="pre">MySQL</span> <span class="pre">server</span> <span class="pre">has</span> <span class="pre">gone</span> <span class="pre">away</span></code> -&gt; Please
refer to <a class="reference internal" href="../configuration_database/linux_database_configuration.html#db-troubleshooting-label"><span class="std std-ref">Troubleshooting</span></a> for more information.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">SQLSTATE[HY000]</span> <span class="pre">[2002]</span> <span class="pre">No</span> <span class="pre">such</span> <span class="pre">file</span> <span class="pre">or</span> <span class="pre">directory</span></code> -&gt; There is a problem
accessing your SQLite database file in your data directory
(<code class="docutils literal notranslate"><span class="pre">data/nextcloud.db</span></code>). Please check the permissions of this folder/file or
if it exists at all. If you’re using MySQL please start your database.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">Connection</span> <span class="pre">closed</span> <span class="pre">/</span> <span class="pre">Operation</span> <span class="pre">cancelled</span></code> -&gt; This could be caused by wrong
<code class="docutils literal notranslate"><span class="pre">KeepAlive</span></code> settings within your Apache config. Make sure that
<code class="docutils literal notranslate"><span class="pre">KeepAlive</span></code> is set to <code class="docutils literal notranslate"><span class="pre">On</span></code> and also try to raise the limits of
<code class="docutils literal notranslate"><span class="pre">KeepAliveTimeout</span></code> and <code class="docutils literal notranslate"><span class="pre">MaxKeepAliveRequests</span></code>.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">No</span> <span class="pre">basic</span> <span class="pre">authentication</span> <span class="pre">headers</span> <span class="pre">were</span> <span class="pre">found</span></code> -&gt; This error is shown in your
<code class="docutils literal notranslate"><span class="pre">data/nextcloud.log</span></code> file. Some Apache modules like <code class="docutils literal notranslate"><span class="pre">mod_fastcgi</span></code>, <code class="docutils literal notranslate"><span class="pre">mod_fcgid</span></code>
or <code class="docutils literal notranslate"><span class="pre">mod_proxy_fcgi</span></code> are not passing the needed authentication headers to
PHP and so the login to Nextcloud via WebDAV, CalDAV and CardDAV clients is
failing.</p></li>
</ul>
</section>
</section>
<section id="troubleshooting-web-server-and-php-problems">
<h2>Troubleshooting Web server and PHP problems<a class="headerlink" href="#troubleshooting-web-server-and-php-problems" title="Link to this heading"></a></h2>
<section id="logfiles">
<h3>Logfiles<a class="headerlink" href="#logfiles" title="Link to this heading"></a></h3>
<p>When having issues the first step is to check the logfiles provided by PHP, the
Web server and Nextcloud itself.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>In the following the paths to the logfiles of a default Debian
installation running Apache2 with mod_php is assumed. On other Web servers,
Linux distros or operating systems they can differ.</p>
</div>
<ul class="simple">
<li><p>The logfile of Apache2 is located in <code class="docutils literal notranslate"><span class="pre">/var/log/apache2/error.log</span></code>.</p></li>
<li><p>The logfile of PHP can be configured in your <code class="docutils literal notranslate"><span class="pre">/etc/php/8.0/apache2/php.ini</span></code>.
You need to set the directive <code class="docutils literal notranslate"><span class="pre">log_errors</span></code> to <code class="docutils literal notranslate"><span class="pre">On</span></code> and choose the path
to store the logfile in the <code class="docutils literal notranslate"><span class="pre">error_log</span></code> directive. After those changes you
need to restart your Web server.</p></li>
<li><p>The logfile of Nextcloud is located in the data directory
<code class="docutils literal notranslate"><span class="pre">/var/www/nextcloud/data/nextcloud.log</span></code>.</p></li>
</ul>
</section>
<section id="web-server-and-php-modules">
<h3>Web server and PHP modules<a class="headerlink" href="#web-server-and-php-modules" title="Link to this heading"></a></h3>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Lighttpd is not supported with Nextcloud, and some Nextcloud features
may not work at all on Lighttpd.</p>
</div>
<p>There are some Web server or PHP modules which are known to cause various
problems like broken uploads/downloads. The following shows a draft overview of
these modules:</p>
<ol class="arabic simple">
<li><p>Apache</p></li>
</ol>
<ul class="simple">
<li><p>mod_pagespeed</p></li>
<li><p>mod_evasive</p></li>
<li><p>mod_security</p></li>
<li><p>mod_reqtimeout</p></li>
<li><p>mod_deflate</p></li>
<li><p>libapache2-mod-php*filter (use libapache2-mod-php8.0 instead)</p></li>
<li><p>mod_spdy together with libapache2-mod-php5 / mod_php (use fcgi or php-fpm
instead)</p></li>
<li><p>mod_dav</p></li>
<li><p>mod_xsendfile / X-Sendfile (causing broken downloads if not configured
correctly)</p></li>
</ul>
<ol class="arabic simple" start="2">
<li><p>NginX</p></li>
</ol>
<ul class="simple">
<li><p>ngx_pagespeed</p></li>
<li><p>HttpDavModule</p></li>
<li><p>X-Sendfile (causing broken downloads if not configured correctly)</p></li>
</ul>
<ol class="arabic simple" start="3">
<li><p>PHP</p></li>
</ol>
<ul class="simple">
<li><p>eAccelerator</p></li>
</ul>
</section>
</section>
<section id="troubleshooting-webdav">
<span id="trouble-webdav-label"></span><h2>Troubleshooting WebDAV<a class="headerlink" href="#troubleshooting-webdav" title="Link to this heading"></a></h2>
<p>Nextcloud uses SabreDAV, and the SabreDAV documentation is comprehensive and
helpful.</p>
<p>See:</p>
<ul class="simple">
<li><p><a class="reference external" href="http://sabre.io/dav/faq/">SabreDAV FAQ</a></p></li>
<li><p><a class="reference external" href="http://sabre.io/dav/webservers">Web servers</a> (Lists lighttpd as not
recommended)</p></li>
<li><p><a class="reference external" href="http://sabre.io/dav/large-files/">Working with large files</a> (Shows a PHP
bug in older SabreDAV versions and information for mod_security problems)</p></li>
<li><p><a class="reference external" href="http://sabre.io/dav/0bytes">0 byte files</a> (Reasons for empty files on the
server)</p></li>
<li><p><a class="reference external" href="http://sabre.io/dav/clients/">Clients</a> (A comprehensive list of WebDAV
clients, and possible problems with each one)</p></li>
<li><p><a class="reference external" href="http://sabre.io/dav/clients/finder/">Finder, OS X’s built-in WebDAV client</a>
(Describes problems with Finder on various Web servers)</p></li>
</ul>
<p>There is also a well maintained FAQ thread available at the <a class="reference external" href="https://central.owncloud.org/t/how-to-fix-caldav-carddav-webdav-problems/852">ownCloud Forums</a>
which contains various additional information about WebDAV problems.</p>
</section>
<section id="service-discovery">
<span id="service-discovery-label"></span><h2>Service discovery<a class="headerlink" href="#service-discovery" title="Link to this heading"></a></h2>
<p>Some clients - especially on iOS/macOS - have problems finding the proper
sync URL, even when explicitly configured to use it.</p>
<p>If you want to use CalDAV or CardDAV clients or other clients that require service discovery
together with Nextcloud it is important to have a correct working setup of the following
URLs:</p>
<div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">https://example.com/.well-known/carddav</span></code></div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">https://example.com/.well-known/caldav</span></code></div>
<div class="line"><br /></div>
</div>
<p>Those need to be redirecting your clients to the correct endpoints. If Nextcloud
is running at the document root of your Web server the correct URL is
<code class="docutils literal notranslate"><span class="pre">https://example.com/remote.php/dav</span></code> for CardDAV and CalDAV and if running in a
subfolder like <code class="docutils literal notranslate"><span class="pre">nextcloud</span></code>, then <code class="docutils literal notranslate"><span class="pre">https://example.com/nextcloud/remote.php/dav</span></code>.</p>
<p>For the first case the <code class="file docutils literal notranslate"><span class="pre">.htaccess</span></code> file shipped with Nextcloud should do
this work for you when you’re running Apache. You need to make sure that your
Web server is using this file. Additionally, you need the mod_rewrite Apache
module installed and <code class="docutils literal notranslate"><span class="pre">AllowOverride</span> <span class="pre">All</span></code> set in your <code class="file docutils literal notranslate"><span class="pre">apache2.conf</span></code>
or vHost-file to process these redirects. When running Nginx please refer to
<a class="reference internal" href="../installation/nginx.html"><span class="doc">NGINX configuration</span></a>.</p>
<p>If your Nextcloud instance is installed in a subfolder called <code class="docutils literal notranslate"><span class="pre">nextcloud</span></code> and
you’re running Apache, create or edit the <code class="file docutils literal notranslate"><span class="pre">.htaccess</span></code> file within the
document root of your Web server and add the following lines:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">&lt;</span><span class="n">IfModule</span> <span class="n">mod_rewrite</span><span class="o">.</span><span class="n">c</span><span class="o">&gt;</span>
<span class="n">RewriteEngine</span> <span class="n">on</span>
<span class="n">RewriteRule</span> <span class="o">^</span>\<span class="o">.</span><span class="n">well</span><span class="o">-</span><span class="n">known</span><span class="o">/</span><span class="n">carddav</span> <span class="o">/</span><span class="n">nextcloud</span><span class="o">/</span><span class="n">remote</span><span class="o">.</span><span class="n">php</span><span class="o">/</span><span class="n">dav</span> <span class="p">[</span><span class="n">R</span><span class="o">=</span><span class="mi">301</span><span class="p">,</span><span class="n">L</span><span class="p">]</span>
<span class="n">RewriteRule</span> <span class="o">^</span>\<span class="o">.</span><span class="n">well</span><span class="o">-</span><span class="n">known</span><span class="o">/</span><span class="n">caldav</span> <span class="o">/</span><span class="n">nextcloud</span><span class="o">/</span><span class="n">remote</span><span class="o">.</span><span class="n">php</span><span class="o">/</span><span class="n">dav</span> <span class="p">[</span><span class="n">R</span><span class="o">=</span><span class="mi">301</span><span class="p">,</span><span class="n">L</span><span class="p">]</span>
<span class="n">RewriteRule</span> <span class="o">^</span>\<span class="o">.</span><span class="n">well</span><span class="o">-</span><span class="n">known</span><span class="o">/</span><span class="n">webfinger</span> <span class="o">/</span><span class="n">nextcloud</span><span class="o">/</span><span class="n">index</span><span class="o">.</span><span class="n">php</span><span class="o">/.</span><span class="n">well</span><span class="o">-</span><span class="n">known</span><span class="o">/</span><span class="n">webfinger</span> <span class="p">[</span><span class="n">R</span><span class="o">=</span><span class="mi">301</span><span class="p">,</span><span class="n">L</span><span class="p">]</span>
<span class="n">RewriteRule</span> <span class="o">^</span>\<span class="o">.</span><span class="n">well</span><span class="o">-</span><span class="n">known</span><span class="o">/</span><span class="n">nodeinfo</span> <span class="o">/</span><span class="n">nextcloud</span><span class="o">/</span><span class="n">index</span><span class="o">.</span><span class="n">php</span><span class="o">/.</span><span class="n">well</span><span class="o">-</span><span class="n">known</span><span class="o">/</span><span class="n">nodeinfo</span> <span class="p">[</span><span class="n">R</span><span class="o">=</span><span class="mi">301</span><span class="p">,</span><span class="n">L</span><span class="p">]</span>
<span class="o">&lt;/</span><span class="n">IfModule</span><span class="o">&gt;</span>
</pre></div>
</div>
<p>Make sure to change /nextcloud to the actual subfolder your Nextcloud instance is running in.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>If you put the above directives directly into an Apache
configuration file (usually within <code class="docutils literal notranslate"><span class="pre">/etc/apache2/</span></code>)
instead of <code class="docutils literal notranslate"><span class="pre">.htaccess</span></code>, you need to prepend the first argument of
each <code class="docutils literal notranslate"><span class="pre">RewriteRule</span></code> option with a forward slash <code class="docutils literal notranslate"><span class="pre">/</span></code>, for example
<code class="docutils literal notranslate"><span class="pre">^/\.well-known/carddav</span></code>.
This is because Apache normalizes paths for the use in <code class="docutils literal notranslate"><span class="pre">.htaccess</span></code>
files by dropping any number of leading slashes, but it does not
do so for the use in its main configuration files.</p>
</div>
<p>If you are running NGINX, make sure <code class="docutils literal notranslate"><span class="pre">location</span> <span class="pre">=</span> <span class="pre">/.well-known/carddav</span> <span class="pre">{</span></code> and <code class="docutils literal notranslate"><span class="pre">location</span> <span class="pre">=</span> <span class="pre">/.well-known/caldav</span> <span class="pre">{</span></code> are properly configured as described in <a class="reference internal" href="../installation/nginx.html"><span class="doc">NGINX configuration</span></a>, adapt to use a subfolder if necessary.</p>
<p>Now change the URL in the client settings to just use:</p>
<p><code class="docutils literal notranslate"><span class="pre">https://example.com</span></code></p>
<p>instead of e.g.</p>
<p><code class="docutils literal notranslate"><span class="pre">https://example.com/nextcloud/remote.php/dav/principals/username</span></code>.</p>
<p>There are also several techniques to remedy this, which are described extensively at
the <a class="reference external" href="http://sabre.io/dav/service-discovery/">Sabre DAV website</a>.</p>
</section>
<section id="troubleshooting-sharing">
<h2>Troubleshooting sharing<a class="headerlink" href="#troubleshooting-sharing" title="Link to this heading"></a></h2>
<section id="users-federated-cloud-ids-not-updated-after-a-domain-name-change">
<h3>Users’ Federated Cloud IDs not updated after a domain name change<a class="headerlink" href="#users-federated-cloud-ids-not-updated-after-a-domain-name-change" title="Link to this heading"></a></h3>
<ol class="arabic simple">
<li><p>run Database query</p></li>
</ol>
<div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">DELETE</span> <span class="pre">FROM</span> <span class="pre">oc_cards_properties</span> <span class="pre">WHERE</span> <span class="pre">name</span> <span class="pre">=</span> <span class="pre">'CLOUD'</span> <span class="pre">AND</span> <span class="pre">addressbookid</span> <span class="pre">=</span> <span class="pre">(select</span> <span class="pre">id</span> <span class="pre">from</span> <span class="pre">oc_addressbooks</span> <span class="pre">where</span> <span class="pre">principaluri</span> <span class="pre">=</span> <span class="pre">'principals/system/system'</span> <span class="pre">AND</span> <span class="pre">uri</span> <span class="pre">=</span> <span class="pre">'system');</span></code></div>
</div>
<ol class="arabic simple" start="2">
<li><p>run occ commands</p></li>
</ol>
<div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">occ</span> <span class="pre">dav:sync-system-addressbook</span></code></div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">occ</span> <span class="pre">federation:sync-addressbooks</span></code></div>
</div>
</section>
</section>
<section id="troubleshooting-file-encoding-on-external-storages">
<span id="trouble-file-encoding-ext-storages"></span><h2>Troubleshooting file encoding on external storages<a class="headerlink" href="#troubleshooting-file-encoding-on-external-storages" title="Link to this heading"></a></h2>
<p>When using external storage, it can happen that some files with special characters will not
appear in the file listing, or they will appear and not be accessible.</p>
<p>When this happens, please run the <a class="reference internal" href="../configuration_server/occ_command.html#occ-files-scan-label"><span class="std std-ref">files scanner</span></a>, for example with:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="o">-</span><span class="n">u</span> <span class="n">www</span><span class="o">-</span><span class="n">data</span> <span class="n">php</span> <span class="n">occ</span> <span class="n">files</span><span class="p">:</span><span class="n">scan</span> <span class="o">--</span><span class="nb">all</span>
</pre></div>
</div>
<p>If the scanner tells about an encoding issue on the affected file, please enable Mac encoding compatibility in the <a class="reference internal" href="../configuration_files/external_storage_configuration_gui.html#external-storage-mount-options-label"><span class="std std-ref">mount options</span></a>
and then <a class="reference internal" href="../configuration_server/occ_command.html#occ-files-scan-label"><span class="std std-ref">rescan the external storage</span></a>.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>This mode comes with a performance impact because Nextcloud will always try both encodings when detecting files
on external storages.</p>
<p>Mac computers are using the NFD Unicode Normalization for file names which is different than NFC, the one used
by other operating systems. Mac users might upload files directly to the external storage using NFD normalized
file names. When uploading through Nextcloud, file names will always be normalized to the NFC standard for consistency.</p>
<p>It is recommended to let Nextcloud use external storages exclusively to avoid such issues.</p>
<p>See also <a class="reference external" href="https://www.win.tue.nl/~aeb/linux/uc/nfc_vs_nfd.html">technical explanation about NFC vs NFD normalizations</a>.</p>
</div>
</section>
<section id="troubleshooting-contacts-calendar">
<h2>Troubleshooting contacts &amp; calendar<a class="headerlink" href="#troubleshooting-contacts-calendar" title="Link to this heading"></a></h2>
<section id="unable-to-update-contacts-or-events">
<h3>Unable to update contacts or events<a class="headerlink" href="#unable-to-update-contacts-or-events" title="Link to this heading"></a></h3>
<p>If you get an error like:</p>
<p><code class="docutils literal notranslate"><span class="pre">PATCH</span> <span class="pre">https://example.com/remote.php/dav</span> <span class="pre">HTTP/1.0</span> <span class="pre">501</span> <span class="pre">Not</span> <span class="pre">Implemented</span></code></p>
<p>it is likely caused by one of the following reasons:</p>
<dl class="simple">
<dt>Using Pound reverse-proxy/load balancer</dt><dd><p>As of writing this Pound doesn’t support the HTTP/1.1 verb.
Pound is easily <a class="reference external" href="http://www.apsis.ch/pound/pound_list/archive/2013/2013-08/1377264673000">patched</a>
to support HTTP/1.1.</p>
</dd>
<dt>Misconfigured Web server</dt><dd><p>Your Web server is misconfigured and blocks the needed DAV methods.
Please refer to <a class="reference internal" href="#trouble-webdav-label"><span class="std std-ref">Troubleshooting WebDAV</span></a> above for troubleshooting steps.</p>
</dd>
</dl>
</section>
</section>
<section id="troubleshooting-data-directory">
<h2>Troubleshooting data-directory<a class="headerlink" href="#troubleshooting-data-directory" title="Link to this heading"></a></h2>
<p>If you have a fresh install, consider reinstalling with your preferred directory location.</p>
<p>Unofficially moving the data directory can be done as follows:</p>
<ol class="arabic simple">
<li><p>Make sure no cron jobs are running</p></li>
<li><p>Stop apache</p></li>
<li><p>Move /data to the new location</p></li>
<li><p>Change the config.php entry</p></li>
<li><p>Edit the database: In oc_storages change the path on the local::/old-data-dir/ entry</p></li>
<li><p>Ensure permissions are still correct</p></li>
<li><p>Restart apache</p></li>
</ol>
<p>For a safe moving of data directory, supported by Nextcloud, recommended actions are:</p>
<ol class="arabic simple">
<li><p>Make sure no cron jobs are running</p></li>
<li><p>Stop apache</p></li>
<li><p>Move /data to the new location</p></li>
<li><p>Create a symlink from the original location to the new location</p></li>
<li><p>Ensure permissions are still correct</p></li>
<li><p>Restart apache</p></li>
</ol>
</section>
<section id="troubleshooting-quota-or-size-issues">
<h2>Troubleshooting quota or size issues<a class="headerlink" href="#troubleshooting-quota-or-size-issues" title="Link to this heading"></a></h2>
<p>Sometimes it can happen that the used space reported in the web UI or with <code class="docutils literal notranslate"><span class="pre">occ</span> <span class="pre">user:info</span> <span class="pre">$userId</span></code>
does not match the actual data stored in the user’s <code class="docutils literal notranslate"><span class="pre">data/$userId/files</span></code> directory.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Metadata, versions, trashbin and encryption keys are not counted in the used space above.
Please refer to the <a class="reference external" href="https://docs.nextcloud.com/server/latest/user_manual/en/files/quota.html">quota documentation</a> for details.</p>
</div>
<p>Running the following command can help fix the sizes and quota for a given user:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="o">-</span><span class="n">u</span> <span class="n">www</span><span class="o">-</span><span class="n">data</span> <span class="n">php</span> <span class="n">occ</span> <span class="n">files</span><span class="p">:</span><span class="n">scan</span> <span class="o">-</span><span class="n">vvv</span> <span class="o">&lt;</span><span class="n">user</span><span class="o">-</span><span class="nb">id</span><span class="o">&gt;</span>
</pre></div>
</div>
<p>If <strong>encryption was enabled earlier on the instance and disabled later on</strong>, it is likely that some
size values in the database did not correctly get reset upon decrypting.
You can run the following SQL query to reset those after <strong>backing up the database</strong>:</p>
<div class="highlight-sql notranslate"><div class="highlight"><pre><span></span><span class="k">UPDATE</span><span class="w"> </span><span class="n">oc_filecache</span><span class="w"> </span><span class="k">SET</span><span class="w"> </span><span class="n">unencrypted_size</span><span class="o">=</span><span class="mi">0</span><span class="w"> </span><span class="k">WHERE</span><span class="w"> </span><span class="k">encrypted</span><span class="o">=</span><span class="mi">0</span><span class="p">;</span>
</pre></div>
</div>
</section>
<section id="troubleshooting-downloading-or-decrypting-files">
<h2>Troubleshooting downloading or decrypting files<a class="headerlink" href="#troubleshooting-downloading-or-decrypting-files" title="Link to this heading"></a></h2>
<section id="bad-signature-error">
<h3>Bad signature error<a class="headerlink" href="#bad-signature-error" title="Link to this heading"></a></h3>
<p>In some rare cases it can happen that encrypted files cannot be downloaded
and return a “500 Internal Server Error”. If the Nextcloud log contains an error about
“Bad Signature”, then the following command can be used to repair affected files:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">occ</span> <span class="n">encryption</span><span class="p">:</span><span class="n">fix</span><span class="o">-</span><span class="n">encrypted</span><span class="o">-</span><span class="n">version</span> <span class="n">userId</span> <span class="o">--</span><span class="n">path</span><span class="o">=/</span><span class="n">path</span><span class="o">/</span><span class="n">to</span><span class="o">/</span><span class="n">broken</span><span class="o">/</span><span class="n">file</span><span class="o">.</span><span class="n">txt</span>
</pre></div>
</div>
<p>Replace “userId” and the path accordingly.
The command will do a test decryption for all files and automatically repair the ones with a signature error.</p>
</section>
<section id="encryption-key-cannot-be-found">
<span id="troubleshooting-encryption-key-not-found"></span><h3>Encryption key cannot be found<a class="headerlink" href="#encryption-key-cannot-be-found" title="Link to this heading"></a></h3>
<p>If the logs contain an error stating that the encryption key cannot be found, you can manually search the data directory for a folder that has the same name as the file name.
For example if a file “example.md” cannot be decrypted, run:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">find</span> <span class="n">path</span><span class="o">/</span><span class="n">to</span><span class="o">/</span><span class="n">datadir</span> <span class="o">-</span><span class="n">name</span> <span class="n">example</span><span class="o">.</span><span class="n">md</span> <span class="o">-</span><span class="nb">type</span> <span class="n">d</span>
</pre></div>
</div>
<p>Then check the results located in the <code class="docutils literal notranslate"><span class="pre">files_encryption</span></code> folder.
If the key folder is in the wrong location, you can move it to the correct folder and try again.</p>
<p>The <code class="docutils literal notranslate"><span class="pre">data/files_encryption</span></code> folder contains encryption keys for group folders and system-wide external storages
while <code class="docutils literal notranslate"><span class="pre">data/$userid/files_encryption</span></code> contains the keys for specific user storage files.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>This can happen if encryption was disabled at some point but the <a class="reference internal" href="../configuration_files/encryption_configuration.html#occ-disable-encryption-label"><span class="std std-ref">occ command for decrypt-all</span></a> was not run, and
then someone moved the files to another location. Since encryption was disabled, the keys did not get moved.</p>
</div>
</section>
<section id="encryption-key-cannot-be-found-with-external-storage-or-group-folders">
<h3>Encryption key cannot be found with external storage or group folders<a class="headerlink" href="#encryption-key-cannot-be-found-with-external-storage-or-group-folders" title="Link to this heading"></a></h3>
<p>To resolve this issue, please run the following command:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="o">-</span><span class="n">u</span> <span class="n">www</span><span class="o">-</span><span class="n">data</span> <span class="n">php</span> <span class="n">occ</span> <span class="n">encryption</span><span class="p">:</span><span class="n">fix</span><span class="o">-</span><span class="n">key</span><span class="o">-</span><span class="n">location</span> <span class="o">&lt;</span><span class="n">user</span><span class="o">-</span><span class="nb">id</span><span class="o">&gt;</span>
</pre></div>
</div>
<p>This will attempt to recover keys that were not moved properly.</p>
<p>If this doesn’t resolve the problem, please refer to the section <a class="reference internal" href="#troubleshooting-encryption-key-not-found"><span class="std std-ref">Encryption key cannot be found</span></a> for a manual procedure.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>There were two known issues where:</p>
<ul class="simple">
<li><p>moving files between an encrypted and non-encrypted storage like external storage or group folder <a class="reference external" href="https://github.com/nextcloud/groupfolders/issues/1896">would not move the keys with the files</a>.</p></li>
<li><p>putting files on system-wide external storage would store the keys in the <a class="reference external" href="https://github.com/nextcloud/server/pull/32690">wrong location</a>.</p></li>
</ul>
</div>
</section>
</section>
<section id="fair-use-policy">
<h2>Fair Use Policy<a class="headerlink" href="#fair-use-policy" title="Link to this heading"></a></h2>
<p>Nextcloud is open source and you can host it for free on your own server or at a provider.</p>
<p>Nextcloud recommends Using Nextcloud Enterprise for deploying instances with more than 500 users. With that size, issues like a broken server or a data leak become very serious.</p>
<p>If there is an issue with the server, 500 people can’t work. A data leak would risk the data of many users. In short, the server should be considered mission-critical. We believe you and your users would have a better experience with Nextcloud Enterprise.</p>
<p>Nextcloud Enterprise is pre-configured and optimised for the needs of professional organisations rather than home users. It comes with support, security and scaling benefits, compliance expertise, and access to our knowledge about running a successful Nextcloud, to get the best possible experience for users and admins. This also reduces the load on our home user forum <a class="reference external" href="http://help.nextcloud.com">http://help.nextcloud.com</a> from issues unique to big deployments.</p>
<p>Nextcloud provides some infrastructure components needed for Nextcloud servers to run reliably. This includes notification, our app store and more. To ensure these resources do not get overloaded by administrators who run Nextcloud for thousands of users without providing financial resources to Nextcloud in return, these components are limited and will not work for more than 500 users.</p>
<p>We believe all organisations who run Nextcloud for hundreds of users should be officially supported. We know there can be financial restrictions for non-profit organisations and, as we want everybody to have a chance to get the most out of Nextcloud, we have special offers for NGOs, small schools and other non-profits. Please reach out to talk to us about what is possible through the <a class="reference external" href="https://nextcloud.com/contact/">contact form on our site</a> or ask your system administrator to reach out.</p>
</section>
<section id="other-issues">
<h2>Other issues<a class="headerlink" href="#other-issues" title="Link to this heading"></a></h2>
<p>Some services like <em>Cloudflare</em> can cause issues by minimizing JavaScript
and loading it only when needed. When having issues like a not working
login button or creating new users make sure to disable such services
first.</p>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="index.html" class="btn btn-neutral float-left" title="Issues and troubleshooting" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="applying_patch.html" class="btn btn-neutral float-right" title="Patching Nextcloud" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; Copyright 2024 Nextcloud GmbH.</p>
</div>
</footer>
</div>
</div>
</section>
</div>
<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="Versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> Read the Docs</span>
v: latest
<span class="fa fa-caret-down"></span>
</span>
<div class="rst-other-versions">
<dl>
<dt>Versions</dt>
<dd><a href="https://docs.nextcloud.com/server/25/admin_manual">25</a></dd>
<dd><a href="https://docs.nextcloud.com/server/26/admin_manual">26</a></dd>
<dd><a href="https://docs.nextcloud.com/server/27/admin_manual">27</a></dd>
<dd><a href="https://docs.nextcloud.com/server/stable/admin_manual">stable</a></dd>
<dd><a href="https://docs.nextcloud.com/server/latest/admin_manual">latest</a></dd>
</dl>
<dl>
<dt>Downloads</dt>
</dl>
<dl>
<dt>On Read the Docs</dt>
<dd>
<a href="///projects//?fromdocs=">Project Home</a>
</dd>
<dd>
<a href="///builds//?fromdocs=">Builds</a>
</dd>
</dl>
</div>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>
wedding-pics/core/doc/admin/issues/index.html
+205
View File
@@ -0,0 +1,205 @@
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Issues and troubleshooting &mdash; Nextcloud latest Administration Manual latest documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../_static/dark_mode_css/general.css" type="text/css" />
<link rel="stylesheet" href="../_static/dark_mode_css/dark.css" type="text/css" />
<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
<script src="../_static/jquery.js?v=5d32c60e"></script>
<script src="../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
<script src="../_static/documentation_options.js?v=c6e86fd7"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/dark_mode_js/default_light.js?v=c2e647ce"></script>
<script src="../_static/dark_mode_js/theme_switcher.js?v=358d3910"></script>
<script src="../_static/js/theme.js"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="General troubleshooting" href="general_troubleshooting.html" />
<link rel="prev" title="Migrating from ownCloud" href="../maintenance/migrating_owncloud.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="../contents.html">
<img src="../_static/logo-white.png" class="logo" alt="Logo"/>
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
<li class="toctree-l1"><a class="reference internal" href="../release_notes/index.html">Release notes</a></li>
<li class="toctree-l1"><a class="reference internal" href="../release_schedule.html">Maintenance and release schedule</a></li>
<li class="toctree-l1"><a class="reference internal" href="../installation/index.html">Installation and server configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_server/index.html">Nextcloud configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../apps_management.html">Apps management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_user/index.html">User management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_files/index.html">File sharing and management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../file_workflows/index.html">Flow</a></li>
<li class="toctree-l1"><a class="reference internal" href="../groupware/index.html">Groupware</a></li>
<li class="toctree-l1"><a class="reference internal" href="../office/index.html">Office</a></li>
<li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../ai/index.html">Artificial Intelligence</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_database/index.html">Database configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_mimetypes/index.html">Mimetypes management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../maintenance/index.html">Maintenance</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Issues and troubleshooting</a><ul>
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html">General troubleshooting</a></li>
<li class="toctree-l2"><a class="reference internal" href="applying_patch.html">Patching Nextcloud</a></li>
<li class="toctree-l2"><a class="reference internal" href="code_signing.html">Code signing</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../gdpr/index.html">GDPR-compliance</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../contents.html">Nextcloud latest Administration Manual</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content style-external-links">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="../contents.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item active">Issues and troubleshooting</li>
<li class="wy-breadcrumbs-aside">
<a href="https://github.com/nextcloud/documentation/edit/master/admin_manual/issues/index.rst" class="fa fa-github"> Edit on GitHub</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="issues-and-troubleshooting">
<h1>Issues and troubleshooting<a class="headerlink" href="#issues-and-troubleshooting" title="Link to this heading"></a></h1>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="general_troubleshooting.html">General troubleshooting</a><ul>
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html#bugs">Bugs</a></li>
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html#id1">General troubleshooting</a></li>
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html#troubleshooting-web-server-and-php-problems">Troubleshooting Web server and PHP problems</a></li>
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html#troubleshooting-webdav">Troubleshooting WebDAV</a></li>
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html#service-discovery">Service discovery</a></li>
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html#troubleshooting-sharing">Troubleshooting sharing</a></li>
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html#troubleshooting-file-encoding-on-external-storages">Troubleshooting file encoding on external storages</a></li>
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html#troubleshooting-contacts-calendar">Troubleshooting contacts &amp; calendar</a></li>
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html#troubleshooting-data-directory">Troubleshooting data-directory</a></li>
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html#troubleshooting-quota-or-size-issues">Troubleshooting quota or size issues</a></li>
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html#troubleshooting-downloading-or-decrypting-files">Troubleshooting downloading or decrypting files</a></li>
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html#fair-use-policy">Fair Use Policy</a></li>
<li class="toctree-l2"><a class="reference internal" href="general_troubleshooting.html#other-issues">Other issues</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="applying_patch.html">Patching Nextcloud</a><ul>
<li class="toctree-l2"><a class="reference internal" href="applying_patch.html#applying-a-patch">Applying a patch</a></li>
<li class="toctree-l2"><a class="reference internal" href="applying_patch.html#reverting-a-patch">Reverting a patch</a></li>
<li class="toctree-l2"><a class="reference internal" href="applying_patch.html#getting-a-patch-from-a-github-pull-request">Getting a patch from a GitHub pull request</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="code_signing.html">Code signing</a><ul>
<li class="toctree-l2"><a class="reference internal" href="code_signing.html#faq">FAQ</a></li>
<li class="toctree-l2"><a class="reference internal" href="code_signing.html#fixing-invalid-code-integrity-messages">Fixing invalid code integrity messages</a></li>
<li class="toctree-l2"><a class="reference internal" href="code_signing.html#rescans">Rescans</a></li>
<li class="toctree-l2"><a class="reference internal" href="code_signing.html#errors">Errors</a></li>
</ul>
</li>
</ul>
</div>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="../maintenance/migrating_owncloud.html" class="btn btn-neutral float-left" title="Migrating from ownCloud" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="general_troubleshooting.html" class="btn btn-neutral float-right" title="General troubleshooting" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; Copyright 2024 Nextcloud GmbH.</p>
</div>
</footer>
</div>
</div>
</section>
</div>
<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="Versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> Read the Docs</span>
v: latest
<span class="fa fa-caret-down"></span>
</span>
<div class="rst-other-versions">
<dl>
<dt>Versions</dt>
<dd><a href="https://docs.nextcloud.com/server/25/admin_manual">25</a></dd>
<dd><a href="https://docs.nextcloud.com/server/26/admin_manual">26</a></dd>
<dd><a href="https://docs.nextcloud.com/server/27/admin_manual">27</a></dd>
<dd><a href="https://docs.nextcloud.com/server/stable/admin_manual">stable</a></dd>
<dd><a href="https://docs.nextcloud.com/server/latest/admin_manual">latest</a></dd>
</dl>
<dl>
<dt>Downloads</dt>
</dl>
<dl>
<dt>On Read the Docs</dt>
<dd>
<a href="///projects//?fromdocs=">Project Home</a>
</dd>
<dd>
<a href="///builds//?fromdocs=">Builds</a>
</dd>
</dl>
</div>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>