Skip to content

Update general_troubleshooting.rst #11394

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
alexknop wants to merge 1 commit into
base: master
Choose a base branch
from
+11 −7
Open

Update general_troubleshooting.rst #11394

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 11 additions & 7 deletions admin_manual/issues/general_troubleshooting.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -273,24 +273,28 @@ URLs:

| ``https://example.com/.well-known/carddav``
| ``https://example.com/.well-known/caldav``
|
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
is running at the ``DocumentRoot`` of your Web server the correct URL is
``https://example.com/remote.php/dav`` for CardDAV and CalDAV and if running in a
subfolder like ``nextcloud``, then ``https://example.com/nextcloud/remote.php/dav``.
subfolder like ``nextcloud``, then the correct URL is ``https://example.com/nextcloud/remote.php/dav``.
Copy link

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The new note directive is directly attached to the preceding paragraph. In reStructuredText, directives like .. note:: should be preceded by a blank line (and usually followed by a blank line) to avoid Sphinx formatting warnings and ensure consistent rendering.

Suggested change
subfolder like ``nextcloud``, then the correct URL is ``https://example.com/nextcloud/remote.php/dav``.
subfolder like ``nextcloud``, then the correct URL is ``https://example.com/nextcloud/remote.php/dav``.

Copilot uses AI. Check for mistakes.
.. note:: By default, the Apache ``DocumentRoot`` is the directory ``/var/www/html``
Copy link

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The statement about Apache's default DocumentRoot being /var/www/html is distro-specific (e.g., Debian/Ubuntu) and not a universal Apache default. Please qualify this (e.g., “On Debian/Ubuntu…”) or rephrase to avoid giving incorrect guidance on other distributions.

Copilot uses AI. Check for mistakes.

For the first case the :file:`.htaccess` file shipped with Nextcloud should do
For the first case, the :file:`.htaccess` 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 ``AllowOverride All`` set in your :file:`apache2.conf`
or vHost-file to process these redirects. When running Nginx please refer to
:doc:`../installation/nginx`.

For the second case, you need to add the following to :file:`/etc/apache2/apache2.conf`::

If your Nextcloud instance is installed in a subfolder called ``nextcloud`` and
you're running Apache, create or edit the :file:`.htaccess` file within the
document root of your Web server and add the following lines::
<Directory /var/www/html>
AllowOverride FileInfo
Copy link

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The config snippet uses a tab character for indentation before AllowOverride FileInfo. Tabs can render inconsistently in code blocks and may violate docs style checks; please replace with spaces and keep indentation consistent across the snippet.

Suggested change
AllowOverride FileInfo
AllowOverride FileInfo

Copilot uses AI. Check for mistakes.
</Directory>
Comment on lines 285 to +294
Copy link

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The section now mentions AllowOverride All (for the first case) but later instructs AllowOverride FileInfo (for the second case). Since the second case only needs rewrite directives, consider aligning the guidance (e.g., document the minimum required override class and why) to avoid confusing readers about which value is correct/safe.

Copilot uses AI. Check for mistakes.

In this, we are using the Apache default ``DocumentRoot`` of ``/var/www/html``, but you should change it to whatever your ``DocumentRoot`` is if it differs.
Next, create or edit the :file:`.htaccess` file within the ``DocumentRoot`` of your Web server and add the following lines::
Comment on lines +296 to +297
Copy link

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This paragraph is a single very long line, while the surrounding documentation wraps lines (typically ~80 chars). Please wrap this text to match the file’s existing formatting and keep diffs/readability consistent.

Suggested change
In this, we are using the Apache default ``DocumentRoot`` of ``/var/www/html``, but you should change it to whatever your ``DocumentRoot`` is if it differs.
Next, create or edit the :file:`.htaccess` file within the ``DocumentRoot`` of your Web server and add the following lines::
In this, we are using the Apache default ``DocumentRoot`` of
``/var/www/html``, but you should change it to whatever your
``DocumentRoot`` is if it differs. Next, create or edit the
:file:`.htaccess` file within the ``DocumentRoot`` of your Web server and
add the following lines::

Copilot uses AI. Check for mistakes.

<IfModule mod_rewrite.c>
RewriteEngine on
Expand Down
Loading