docs(installation): refine Apache source installation guidance#15277
Open
joshtrichards wants to merge 1 commit into
Open
docs(installation): refine Apache source installation guidance#15277joshtrichards wants to merge 1 commit into
joshtrichards wants to merge 1 commit into
Conversation
Signed-off-by: Josh <josh.t.richards@gmail.com>
Contributor
📖 Documentation Preview📄 1 changed documentation pageLast updated: Thu, 02 Jul 2026 23:38:46 GMT |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR refines the admin manual “source installation” guide to make Apache-based deployments clearer by prioritizing a dedicated virtual host setup, keeping subdirectory installs as a secondary option, and relocating PHP-FPM/FastCGI-specific Apache details into the PHP-FPM section.
Changes:
- Restructures the manual installation introduction and prerequisites to improve flow and clarity.
- Reworks the Apache configuration section to lead with a minimal virtual host example and keep Alias/subdirectory setup as an alternative.
- Adds an Apache integration subsection under PHP-FPM configuration and cross-references it from the Apache section.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
+10
to
+13
| The :ref:`manual_installation_label` section provides a complete walk-through | ||
| for installing Nextcloud for use with Apache and MariaDB, using `the Nextcloud | ||
| .tar archive <https://nextcloud.com/install/>`_. Usage with other web servers | ||
| (e.g. Nginx) and database backends are also covered. |
Comment on lines
+29
to
+30
| Manual Installation | ||
| =================== |
Comment on lines
+32
to
+34
| This installation guide is giving a general overview of required dependencies | ||
| and their configuration. For distribution specific setup guide have a look at | ||
| the :doc:`./example_ubuntu`, :doc:`./example_centos`, etc. |
Comment on lines
+115
to
+119
| If you have configured authentication for a parent directory, disable it | ||
| for the Nextcloud location. Following the examples above, add the | ||
| following line to the ``<Directory>`` section:: | ||
|
|
||
| a2enmod proxy | ||
| a2enmod proxy_fcgi | ||
| Satisfy Any |
| <FilesMatch remote.php> | ||
| SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1 | ||
| </FilesMatch> | ||
| If you are using ``php-fpm`` or ``mod_fcgi``, see |
Comment on lines
+286
to
+287
| * If you're using ``mod_fcgi`` or ``php-fpm`` (PHP FastCGI Process Manager), | ||
| you must enable the proxy modules:: |
| a2enmod proxy | ||
| a2enmod proxy_fcgi | ||
|
|
||
| If you're running ``mod_fcgi`` instead of the standard ``mod_php`` also enable:: |
Comment on lines
153
to
157
| To verify that required modules are enabled, use the ``apache2ctl`` command:: | ||
|
|
||
| apache2ctl -M | grep -E "rewrite|proxy|proxy_fcgi" | ||
| apache2ctl -M | grep -E "rewrite|headers|env|dir|mime" | ||
|
|
||
| If you see matching output for the modules you've enabled, they are active. |
Comment on lines
158
to
160
| 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). |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
☑️ Resolves
This refines the Apache section of the manual source installation guide to make the recommended setup clearer and a bit easier to follow.
Changes
PHP-FPM configurationsection underPrerequisitesphp-fpm/mod_fcgiusersRationale
The goal here is to improve the flow of the Apache instructions without trying to fully rewrite the larger installation page all at once. This keeps the main Apache path more focused, reduces context switching, and puts the PHP-FPM-specific details closer to the section where they belong.
🖼️ Screenshots
✅ Checklist
codespellor similar and addressed any spelling issues