| Server IP : 184.154.167.98 / Your IP : 18.218.113.187 Web Server : Apache System : Linux pink.dnsnetservice.com 4.18.0-553.22.1.lve.1.el8.x86_64 #1 SMP Tue Oct 8 15:52:54 UTC 2024 x86_64 User : puertode ( 1767) PHP Version : 7.2.34 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /home/puertode/public_html/sesiones/core/doc/admin/issues/ |
Upload File : |
<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>General troubleshooting — Nextcloud latest Administration Manual latest documentation</title>
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
<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="Issues and troubleshooting" href="index.html" />
<script src="../_static/js/modernizr.min.js"></script>
</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" />
<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="main navigation">
<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.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">File workflows</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-contacts-calendar">Troubleshooting contacts & 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="#other-issues">Other issues</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</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" aria-label="top navigation">
<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="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="../contents.html">Docs</a> »</li>
<li><a href="index.html">Issues and troubleshooting</a> »</li>
<li>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">
<div class="section" id="general-troubleshooting">
<h1>General troubleshooting<a class="headerlink" href="#general-troubleshooting" title="Permalink to this headline">¶</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="first docutils">
<dt><a class="reference external" href="https://help.nextcloud.com">The Nextcloud Forums</a></dt>
<dd>The Nextcloud forums have a <a class="reference external" href="https://help.nextcloud.com/c/faq">FAQ page</a> where each topic corresponds
to typical mistakes or frequently occurring issues</dd>
</dl>
</li>
<li>The Nextcloud IRC chat channel <code class="docutils literal notranslate"><span class="pre">irc://#nextcloud@freenode.net</span></code> on
freenode.net, also accessible via <a class="reference external" href="http://webchat.freenode.net/?channels=nextcloudhttps://docs.nextcloud.org/server/14/developer_manual/bugtracker/index.html">webchat</a></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>
<div class="section" id="bugs">
<h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
<p>If you think you have found a bug in Nextcloud, please:</p>
<ul class="simple">
<li>Search for a solution (see the options above)</li>
<li>Double-check your configuration</li>
</ul>
<p>If you can’t find a solution, please use our <a class="reference external" href="https://github.com/nextcloud/server/issues">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>
</div>
<div class="section" id="id1">
<h2>General troubleshooting<a class="headerlink" href="#id1" title="Permalink to this headline">¶</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>
<div class="section" id="disable-3rdparty-non-shipped-apps">
<h3>Disable 3rdparty / non-shipped apps<a class="headerlink" href="#disable-3rdparty-non-shipped-apps" title="Permalink to this headline">¶</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>
</div>
<div class="section" id="nextcloud-logfiles">
<h3>Nextcloud logfiles<a class="headerlink" href="#nextcloud-logfiles" title="Permalink to this headline">¶</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">=></span> <span class="pre">false,</span></code> to
<code class="docutils literal notranslate"><span class="pre">'debug'</span> <span class="pre">=></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="first admonition-title">Note</p>
<p class="last">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>
</div>
<div class="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="Permalink to this headline">¶</a></h3>
<p>You will need to know your PHP version and configurations. To do this, 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><?php phpinfo(); ?>
</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>
<div class="figure">
<img alt="../_images/phpinfo.png" src="../_images/phpinfo.png" />
</div>
<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>
</div>
<div class="section" id="debugging-sync-issues">
<h3>Debugging sync issues<a class="headerlink" href="#debugging-sync-issues" title="Permalink to this headline">¶</a></h3>
<div class="admonition warning">
<p class="first admonition-title">Warning</p>
<p class="last">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>Problems with sync clients</li>
<li>Undetected changes due to caching in the database</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>
</div>
<div class="section" id="common-problems-error-messages">
<h3>Common problems / error messages<a class="headerlink" href="#common-problems-error-messages" title="Permalink to this headline">¶</a></h3>
<p>Some common problems / error messages found in your logfiles as described above:</p>
<ul class="simple">
<li><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> -> You need to increase the
connection limit of your database, please refer to the manual of your database
for more information.</li>
<li><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> -> 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>.</li>
<li><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> -> 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.</li>
<li><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> -> 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.</li>
<li><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> -> 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>.</li>
<li><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> -> 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. Information on how to correctly configure your environment can be
found at the <a class="reference external" href="https://forum.owncloud.org/viewtopic.php?f=17&t=30646">forums</a>.</li>
</ul>
</div>
</div>
<div class="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="Permalink to this headline">¶</a></h2>
<div class="section" id="logfiles">
<h3>Logfiles<a class="headerlink" href="#logfiles" title="Permalink to this headline">¶</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="first admonition-title">Note</p>
<p class="last">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>The logfile of Apache2 is located in <code class="docutils literal notranslate"><span class="pre">/var/log/apache2/error.log</span></code>.</li>
<li>The logfile of PHP can be configured in your <code class="docutils literal notranslate"><span class="pre">/etc/php5/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.</li>
<li>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>.</li>
</ul>
</div>
<div class="section" id="web-server-and-php-modules">
<h3>Web server and PHP modules<a class="headerlink" href="#web-server-and-php-modules" title="Permalink to this headline">¶</a></h3>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">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 up-/downloads. The following shows a draft overview of
these modules:</p>
<ol class="arabic simple">
<li>Apache</li>
</ol>
<ul class="simple">
<li>mod_pagespeed</li>
<li>mod_evasive</li>
<li>mod_security</li>
<li>mod_reqtimeout</li>
<li>mod_deflate</li>
<li>libapache2-mod-php5filter (use libapache2-mod-php5 instead)</li>
<li>mod_spdy together with libapache2-mod-php5 / mod_php (use fcgi or php-fpm
instead)</li>
<li>mod_dav</li>
<li>mod_xsendfile / X-Sendfile (causing broken downloads if not configured
correctly)</li>
</ul>
<ol class="arabic simple" start="2">
<li>NginX</li>
</ol>
<ul class="simple">
<li>ngx_pagespeed</li>
<li>HttpDavModule</li>
<li>X-Sendfile (causing broken downloads if not configured correctly)</li>
</ul>
<ol class="arabic simple" start="3">
<li>PHP</li>
</ol>
<ul class="simple">
<li>eAccelerator</li>
</ul>
</div>
</div>
<div class="section" id="troubleshooting-webdav">
<span id="trouble-webdav-label"></span><h2>Troubleshooting WebDAV<a class="headerlink" href="#troubleshooting-webdav" title="Permalink to this headline">¶</a></h2>
<p>Nextcloud uses SabreDAV, and the SabreDAV documentation is comprehensive and
helpful.</p>
<p>See:</p>
<ul class="simple">
<li><a class="reference external" href="http://sabre.io/dav/faq/">SabreDAV FAQ</a></li>
<li><a class="reference external" href="http://sabre.io/dav/webservers">Web servers</a> (Lists lighttpd as not
recommended)</li>
<li><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)</li>
<li><a class="reference external" href="http://sabre.io/dav/0bytes">0 byte files</a> (Reasons for empty files on the
server)</li>
<li><a class="reference external" href="http://sabre.io/dav/clients/">Clients</a> (A comprehensive list of WebDAV
clients, and possible problems with each one)</li>
<li><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)</li>
</ul>
<p>There is also a well maintained FAQ thread available at the <a class="reference external" href="https://forum.owncloud.org/viewtopic.php?f=17&t=7536">ownCloud Forums</a>
which contains various additional information about WebDAV problems.</p>
</div>
<div class="section" id="service-discovery">
<span id="service-discovery-label"></span><h2>Service discovery<a class="headerlink" href="#service-discovery" title="Permalink to this headline">¶</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"><code class="docutils literal notranslate"><span class="pre">https://example.com/.well-known/webfinger</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:</p>
<p><code class="docutils literal notranslate"><span class="pre">https://example.com/remote.php/dav</span></code> for CardDAV and CalDAV and
<code class="docutils literal notranslate"><span class="pre">https://example.com/public.php?service=webfinger</span></code></p>
<p>and if running in a subfolder like <code class="docutils literal notranslate"><span class="pre">nextcloud</span></code>:</p>
<p><code class="docutils literal notranslate"><span class="pre">https://example.com/nextcloud/remote.php/dav</span></code>
<code class="docutils literal notranslate"><span class="pre">https://example.com/nextcloud/public.php?service=webfinger</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 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><IfModule mod_rewrite.c>
RewriteEngine on
RewriteRule ^\.well-known/host-meta /nextcloud/public.php?service=host-meta [QSA,L]
RewriteRule ^\.well-known/host-meta\.json /nextcloud/public.php?service=host-meta-json [QSA,L]
RewriteRule ^\.well-known/webfinger /nextcloud/public.php?service=webfinger [QSA,L]
RewriteRule ^\.well-known/carddav /nextcloud/remote.php/dav/ [R=301,L]
RewriteRule ^\.well-known/caldav /nextcloud/remote.php/dav/ [R=301,L]
</IfModule>
</pre></div>
</div>
<p>Make sure to change /nextcloud to the actual subfolder your Nextcloud instance is running in.</p>
<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>
</div>
<div class="section" id="troubleshooting-contacts-calendar">
<h2>Troubleshooting contacts & calendar<a class="headerlink" href="#troubleshooting-contacts-calendar" title="Permalink to this headline">¶</a></h2>
<div class="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="Permalink to this headline">¶</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="docutils">
<dt>Using Pound reverse-proxy/load balancer</dt>
<dd>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.</dd>
<dt>Misconfigured Web server</dt>
<dd>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.</dd>
</dl>
</div>
</div>
<div class="section" id="troubleshooting-data-directory">
<h2>Troubleshooting data-directory<a class="headerlink" href="#troubleshooting-data-directory" title="Permalink to this headline">¶</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>Make sure no cron jobs are running</li>
<li>Stop apache</li>
<li>Move /data to the new location</li>
<li>Change the config.php entry</li>
<li>Edit the database: In oc_storages change the path on the local::/old-data-dir/ entry</li>
<li>Ensure permissions are still correct</li>
<li>Restart apache</li>
</ol>
<p>For a safe moving of data directory, supported by Nextcloud, recommended actions are:</p>
<ol class="arabic simple">
<li>Make sure no cron jobs are running</li>
<li>Stop apache</li>
<li>Move /data to the new location</li>
<li>Create a symlink from the original location to the new location</li>
<li>Ensure permissions are still correct</li>
<li>Restart apache</li>
</ol>
</div>
<div class="section" id="other-issues">
<h2>Other issues<a class="headerlink" href="#other-issues" title="Permalink to this headline">¶</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>
</div>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<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"></span></a>
<a href="index.html" class="btn btn-neutral" title="Issues and troubleshooting" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
© Copyright 2020 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/15/admin_manual">15</a></dd>
<dd><a href="https://docs.nextcloud.com/server/16/admin_manual">16</a></dd>
<dd><a href="https://docs.nextcloud.com/server/17/admin_manual">17</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>
<hr/>
Free document hosting provided by <a href="http://www.readthedocs.org">Read the Docs</a>.
</div>
</div>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script type="text/javascript" src="../_static/language_data.js"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>