Ubuntu 24.04 LTS – Apache returns 503 because php-fpm socket mismatch – Fix & Prevention

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

Dynamic PHP pages fail with HTTP 503 while static assets continue to load.

Environment & Reproduction

Ubuntu 24.04 LTS with apache2 and php-fpm using unix socket proxy configuration.

Root Cause Analysis

Apache vhost references old PHP socket path after PHP version or pool change.

Quick Triage

Check apache error.log for AH01079 and inspect running php-fpm sockets under /run/php.

Step-by-Step Diagnosis

Compare SetHandler proxy target with active php-fpm pool listen directive values.

Solution – Primary Fix

Update Apache handler to correct php-fpm socket, restart php-fpm and reload apache2.

Solution – Alternative Approaches

Use TCP listen mode for php-fpm pools where socket path churn complicates operations.

Verification & Acceptance Criteria

PHP test page executes correctly and 503 responses disappear from access logs.

Rollback Plan

Revert vhost and pool configuration to previous known-good PHP version mapping.

Prevention & Hardening

Template Apache and php-fpm configs together to prevent drift after package upgrades.

Related Errors & Cross-Refs

Permission mismatch on socket file and disabled proxy_fcgi module also cause 503 conditions.

Related tutorial: View the step-by-step tutorial for Ubuntu 24.04 LTS.

View all Ubuntu 24.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Apache and PHP-FPM integration references for Ubuntu web stacks.