Skip to content

Document required Apache modules for PHP-FPM setup#14794

Merged
skjnldsv merged 1 commit intomasterfrom
fix/document-apache-modules
May 7, 2026
Merged

Document required Apache modules for PHP-FPM setup#14794
skjnldsv merged 1 commit intomasterfrom
fix/document-apache-modules

Conversation

@skjnldsv
Copy link
Copy Markdown
Member

@skjnldsv skjnldsv commented May 7, 2026

Summary

Adds explicit documentation about required Apache modules when using PHP-FPM with Nextcloud.

Problem

The Apache configuration guide doesn't clearly document that proxy_module and proxy_fcgi_module are required when using php-fpm instead of mod_php. This causes confusion for users on distributions like Raspberry Pi OS, where these modules may not be enabled by default. Users encounter connection or configuration errors without understanding what modules are missing.

Solution

  1. Reorganized the "Additional Apache configurations" section to clearly separate required modules from recommended modules
  2. Explicitly listed proxy_module and proxy_fcgi_module as required for php-fpm setups with a2enmod commands
  3. Added apache2ctl -M verification command and troubleshooting guidance
  4. Included note about distribution-specific package names

Changes

Relates to

#14036

Explicitly list proxy_module and proxy_fcgi_module as required when using
php-fpm instead of mod_php. Includes command to verify modules are enabled.
Helps troubleshoot missing modules on distributions like RPi OS.

Signed-off-by: skjnldsv <skjnldsv@protonmail.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 7, 2026

📖 Documentation Preview

🔍 Open preview →

📄 1 changed documentation page

Last updated: Thu, 07 May 2026 09:26:19 GMT

@skjnldsv skjnldsv merged commit 77e1f7a into master May 7, 2026
24 of 25 checks passed
@skjnldsv skjnldsv deleted the fix/document-apache-modules branch May 7, 2026 09:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants