504 HTTP Origin: Network Last updated 10 Oct 2026

HTTP 504 Gateway Timeout

A proxy or gateway waited too long for the upstream server to respond and gave up.

Exact message you may see gateway timeout504 Gateway Time-outupstream timed outEndpoint request timed out
Explore the map of this error Full error map →
Seen on: Nginx PHP AWS Cloudflare

Meaning

The upstream is reachable but slow. The proxy (Nginx, ALB, API Gateway, Cloudflare) has a read timeout — default 60s in Nginx, 60s idle on ALB, 29s on AWS API Gateway, 100s on Cloudflare (which shows 524) — and the app didn’t finish in time.

Common causes

  • Slow database query or missing index
  • Long-running work done synchronously in the request (reports, imports, emails)
  • Slow third-party API call without its own timeout
  • Upstream overloaded and queueing requests
  • Proxy timeout lower than the app’s legitimate processing time
  • DNS or network issues between proxy and upstream

⚡ Quick fix

  1. Find which request is slow and why (APM, slow query log, app timing logs)
  2. Move long work to a background job and return 202 + polling
  3. Add timeouts to outbound calls so they fail fast
  4. Only then, raise proxy timeouts if the work is legitimately long

Detailed fix by platform

Nginx

  1. Raise timeouts (proxy or FastCGI):
    nginx
    proxy_read_timeout 120s;
proxy_connect_timeout 10s;
fastcgi_read_timeout 120s;   # for PHP-FPM

PHP

  1. Also check max_execution_time and PHP-FPM request_terminate_timeout — whichever is lowest wins.

AWS

  1. API Gateway REST integrations max out at 29 seconds by default — use async patterns for longer work. ALB idle timeout is configurable (default 60s).

Cloudflare

  1. Cloudflare’s equivalent is 524 (100s limit on most plans).

How to diagnose

  1. Timing — How long does the upstream actually take for this request?
  2. Bottleneck — DB query, external API, CPU?
  3. Timeouts — List every timeout in the chain — the smallest one fires
  4. Load — Is it slow only under load?

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: Network. Errors that are often confused with or caused by this one (click to open):

103 — HTTP 103 Early Hints (HTTP)1031200 — Cloudflare Error 1200: Cache connection limit (Cloudflare)12002013 — MySQL ERROR 2013 (HY000): Lost connection to MySQL server during query (MySQL)2013408 — HTTP 408 Request Timeout (HTTP)408499 — HTTP 499 Client Closed Request (Nginx) (HTTP)499502 — HTTP 502 Bad Gateway (HTTP)502503 — HTTP 503 Service Unavailable (HTTP)503522 — Cloudflare Error 522: Connection Timed Out (Cloudflare)522504

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.