Skip to content
Merged
Changes from all commits
Commits
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
21 changes: 20 additions & 1 deletion admin_manual/installation/source_installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -106,12 +106,20 @@ command to enable the configuration::
Additional Apache configurations
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

**Required modules:**

* For Nextcloud to work correctly, we need the module ``mod_rewrite``. Enable
it by running::

a2enmod rewrite

Additional recommended modules are ``mod_headers``, ``mod_env``, ``mod_dir`` and ``mod_mime``::
* If you're using ``mod_fcgi`` or ``php-fpm`` (PHP FastCGI Process Manager),
you must enable the proxy modules::

a2enmod proxy
a2enmod proxy_fcgi

**Recommended modules** are ``mod_headers``, ``mod_env``, ``mod_dir`` and ``mod_mime``::

a2enmod headers
a2enmod env
Expand All @@ -130,6 +138,17 @@ Additional Apache configurations
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
</FilesMatch>

**Verifying modules are enabled:**

To verify that required modules are enabled, use the ``apache2ctl`` command::

apache2ctl -M | grep -E "rewrite|proxy|proxy_fcgi"

If you see matching output for the modules you've enabled, they are active.
If any required module is missing, troubleshoot your OS package manager to
ensure the Apache modules are installed (package names may vary by distribution;
for example, on Debian/Ubuntu look for ``libapache2-mod-fcgid`` or similar).

* You must disable any server-configured authentication for Nextcloud, as it
uses Basic authentication internally for DAV services. If you have turned on
authentication on a parent folder (via e.g. an ``AuthType Basic``
Expand Down
Loading