HTTP 504 Gateway Timeout (nginx): causes & fix
nginx reached the backend but did not get a response within the configured timeout (60 seconds by default). Common causes Long-running requests: large uploads, exports, reports, image processing. The PHP-FPM
nginx reached the backend but did not get a response within the configured timeout (60 seconds by default).
Common causes
- Long-running requests: large uploads, exports, reports, image processing.
- The PHP-FPM pool is full (
pm.max_childrenreached) and new requests wait in line. - Slow or locked database queries.
-
fastcgi_read_timeoutorproxy_read_timeouttoo low for the use case. - Backend on another host unreachable through network or firewall (connect runs into the timeout).
How to check it
Find timeouts in the nginx log
grep 'upstream timed out' /var/log/nginx/error.log | tail -n 20
Check whether PHP-FPM hits its limit
grep -i 'max_children' /var/log/php8.3-fpm.log
Measure response time precisely
curl -s -o /dev/null -w 'connect=%{time_connect} ttfb=%{time_starttransfer} total=%{time_total}\n' https://cloud.example.com/status.php
What actually helps
- Fix the cause first: optimise slow queries, add indexes, move long jobs to cron or a queue.
- Raise
pm.max_childrenaccording to RAM (RAM for PHP divided by memory per worker). - Raise timeouts together:
fastcgi_read_timeout 300s;in nginx plusmax_execution_timeandrequest_terminate_timeoutin PHP-FPM.
FAQ
Should I just set the timeout to 3600 seconds?
No. It hides the problem and ties up workers. Raise timeouts only for specific locations such as upload or export paths.
Why do I get a 504 while PHP keeps running?
nginx only drops the connection to the client. The PHP script continues until max_execution_time or request_terminate_timeout kicks in.
Full page with every command and the German/Italian version: daniele-michelin.com/en/errors/http-504-gateway-timeout/
First published at daniele-michelin.com. The error lexicon covers HTTP, DNS, TLS, mail, database, PHP, nginx, systemd and Nextcloud, in German, English and Italian.
Originally published by Dev.to WebDev. Aggregated on AIWithGhost for educational purposes — full credit and traffic to the original publisher.