Cloudflare Error 524: the origin took longer than 125 seconds

TL;DR

For "Proxy Read Timeout": put long-running requests behind a DNS-only (gray-clouded) subdomain so Cloudflare's timeouts do not apply. The documented workaround for long HTTP processes: return quickly with a job id, let the client poll for completion. Do not hold the connection open. Teams "fix" 524 by retrying faster, which multiplies the long-running load on an already struggling origin.

Proxy Read Timeout

When to use

You are seeing this: Cloudflare successfully connected to the origin, but the origin did not send an HTTP response before the default 125-second Proxy Read Timeout. Use this skill when you run into "Cloudflare Error 524: the origin took longer than 125 seconds".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Error 524: a timeout occurred

Cloudflare successfully connected to the origin, but the origin did not send an HTTP response before the default 125-second Proxy Read Timeout.

Common causes

• A long-running process on the origin (large data query, report generation, big export).
• An overloaded origin that cannot return data in time.

Note the sibling timeout: if the origin accepts the connection for a write but the write does not complete within 30 seconds (Proxy Write Timeout), that also surfaces as a 524. That timeout cannot be adjusted.

The fixes

1. Status polling. The documented workaround for long HTTP processes: return quickly with a job id, let the client poll for completion. Do not hold the connection open.
2. Move the slow endpoint off the proxied path. Put long-running requests behind a DNS-only (gray-clouded) subdomain so Cloudflare's timeouts do not apply.
3. Raise the timeout (Enterprise). Up to 6,000 seconds, either via a Cache Rule with the Proxy Read Timeout setting (the content must be cacheable for the rule to trigger, though it does not need to be cached) or the Edit zone setting API for the whole zone.

The failure mode

Teams "fix" 524 by retrying faster, which multiplies the long-running load on an already struggling origin. Back off, then restructure.

Checklist

• Confirm with cf-error-type that it is a 524 (origin timeout), not a Worker 1102 (your code is slow).
• For exports and reports: poll, do not hold.
• If the workload legitimately needs minutes, DNS-only subdomain or Enterprise timeout raise.

Verified against the live Error 524 support doc: 125s Proxy Read Timeout, 30s Proxy Write Timeout (not adjustable), status-polling workaround, DNS-only subdomain for long requests, Enterprise raise to 6000s via Cache Rule setting or zone API. Ref: https://developers.cloudflare.com/support/troubleshooting/http-status-codes/cloudflare-5xx-errors/error-524/