October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk8 min

How to Stop Nginx Buffering POST Requests

Set proxy_request_buffering off in the upload location to stream POST bodies to your upstream. Learn how it differs from proxy_buffering, how protocol and version caveats affect behavior, and how to verify the live configuration.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For a proxied POST endpoint, set proxy_request_buffering off; in the location that handles the request, then validate and reload NGINX. With request buffering disabled, NGINX forwards the body to the upstream as it receives it instead of waiting for the complete upload.

location /upload/ {
    proxy_request_buffering off;
    proxy_pass http://backend;
}

Use the request-body directive, not the response directive

NGINX has two similarly named settings that operate on opposite directions of a proxied exchange:

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Directive Data it controls Default What setting it off does
proxy_request_buffering Request body travelling from the client to the upstream server on Sends the body upstream as NGINX receives it
proxy_buffering Response body travelling from the upstream server to the client on Passes the upstream response to the client without response buffering
client_body_buffer_size Memory used while NGINX reads the client request body 8K or 16K, depending on platform Changing it alters memory and temporary-file behavior; it does not enable upstream streaming

If an upload reaches your application only after the client has finished sending it, the relevant control is proxy_request_buffering. Turning off proxy_buffering cannot change when NGINX sends the incoming POST body.

Configure buffering only where streaming is required

The directive can be placed in the http, server, or location context. A location-specific rule is usually the safest choice because it limits the behavior to endpoints designed to accept streaming uploads.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.

Minimal upload location

location /upload/ {
    proxy_request_buffering off;
    proxy_pass http://backend;
}

Replace /upload/ with the URI handled by your POST endpoint and replace http://backend with the upstream definition used by your deployment. The directive is inherited from the previous configuration level only when no directive is declared at the current level, so a more-specific location can change the effective value.

Mixed buffered and streaming endpoints

http {
    upstream app_backend {
        server 127.0.0.1:8080;
    }

    server {
        listen 80;
        server_name example.test;

        location /upload/ {
            proxy_request_buffering off;
            proxy_pass http://app_backend;
        }

        location /api/ {
            proxy_pass http://app_backend;
        }
    }
}

In this pattern, only requests under /upload/ stream their bodies to the application. Other proxied requests retain the default request buffering behavior. Keeping the scope narrow reduces the number of requests that can consume upstream connection time while a client is still transmitting.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Applying a server-wide or HTTP-wide policy

You can set the directive in server when every proxied endpoint in that virtual host needs the same behavior, or in http when it is a deliberate policy for all applicable servers. Check every nested location before doing this: a child block may override the inherited value, and a broad setting can expose endpoints that were not designed to process partial request bodies.

Validate the configuration and reload NGINX

  1. Inspect the complete active configuration. Run nginx -T with the privileges used to administer NGINX. Search the output for the target location, all nested locations, and every occurrence of proxy_request_buffering.
  2. Check the syntax before reloading. Run nginx -t. Do not reload if the test reports an error; fix the reported file and line first.
  3. Reload the running process. Use the reload mechanism provided by your service manager after a successful syntax test. A reload applies the new configuration without requiring a full stop and start.
  4. Confirm that the request matches the intended location. NGINX location selection can send a URI to a more-specific prefix or regular-expression location than the one you edited. Add temporary, clearly identifiable logging if necessary, then remove it after verification.
  5. Test the running instance, not only the file on disk. A correct file has no effect until the process has loaded it. Re-run nginx -T after the reload if you need to confirm the generated configuration seen by the active process.

How request buffering changes the upload path

With request buffering enabled, NGINX reads the entire request body from the client before sending the request to the proxied server. Depending on body size and the memory available for request processing, data can be held in memory or written to a temporary file.

With proxy_request_buffering off, NGINX sends the request body to the upstream immediately as it receives it. This lets an application begin parsing or storing an upload while the client is still transmitting, which is the behavior needed for long-running uploads, streaming ingestion, and endpoints that must react before the final byte arrives.

Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

Disabling buffering does not remove the need for an application-level request-size limit, authentication, timeouts, or storage controls. It changes when bytes are forwarded; it does not make an untrusted upload safe by itself.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Do not confuse request buffering with response buffering

proxy_buffering off; addresses a different symptom: the upstream has already produced a response, but NGINX is holding response data before delivering it to the client. Use it only when the response itself must be delivered incrementally or synchronously.

location /events/ {
    proxy_buffering off;
    proxy_pass http://backend;
}

This example does not stream the incoming POST body. If an endpoint needs both directions to be incremental, configure both directives deliberately and document why each is present:

location /stream-upload/ {
    proxy_request_buffering off;
    proxy_buffering off;
    proxy_pass http://backend;
}

Most upload endpoints need only the first directive. Turning off response buffering unnecessarily can change response memory usage and delivery behavior, so treat it as a separate decision.

What client_body_buffer_size does—and does not do

client_body_buffer_size controls the memory buffer NGINX uses while reading a request body from the client. The documented default is 8K or 16K, depending on platform. If the body exceeds that buffer, all or part of it may be written to a temporary file.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by

Raising the value can reduce temporary-file writes for bodies that fit in the larger buffer, but it increases potential per-request memory consumption. Lowering it can cause more data to spill to disk. Neither change tells NGINX to forward the body upstream as it arrives.

Symptom Setting to investigate Reason
The application receives nothing until the upload finishes proxy_request_buffering Request-body forwarding is being delayed
Temporary files grow during large uploads client_body_buffer_size and request-body temporary-file storage The body exceeds the in-memory request buffer
The client receives a response in bursts proxy_buffering NGINX is buffering the upstream response

Protocol and NGINX version caveats

Chunked HTTP/1.1 request bodies

When a client uses HTTP/1.1 chunked transfer encoding, NGINX can still buffer the original request body even when proxy_request_buffering off is set, unless HTTP/1.1 or HTTP/2 is enabled for proxying. If slow chunked uploads continue to arrive at the upstream only after completion, inspect the protocol used between NGINX and the upstream rather than assuming the directive was ignored.

For an HTTP/1.1 upstream connection, make the proxy protocol choice explicit in the location when that matches the backend’s requirements:

location /chunked-upload/ {
    proxy_request_buffering off;
    proxy_http_version 1.1;
    proxy_pass http://backend;
}

The correct protocol depends on the upstream and the rest of your configuration. Verify it from the effective configuration and from upstream-side observations; a client using HTTP/2 does not automatically mean that the NGINX-to-upstream hop is HTTP/2.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

HTTP/2 support in older NGINX releases

Before NGINX 1.9.14, HTTP/2 request-body buffering could not be disabled. An older installation therefore cannot provide unbuffered HTTP/2 request bodies simply by adding the directive. Check the running version and upgrade before relying on this behavior for HTTP/2 traffic.

Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.

The directive was added in NGINX 1.7.11

proxy_request_buffering appeared in NGINX 1.7.11. If a configuration parser rejects the directive, the installed version is a primary suspect. Confirm the binary version and the configuration actually loaded by the running process before changing unrelated settings.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Understand the failover trade-off

Once NGINX has started sending a request body to an upstream, it cannot hand that same request to a different upstream. This matters when an upstream pool is configured for failover: a failure detected after body transmission begins cannot be treated like a failure found before any request data was sent.

Before disabling request buffering, decide how the application handles a connection that ends halfway through an upload. It may need resumable-upload logic, cleanup of partial files, idempotency keys, or a way to distinguish a client disconnect from an application error. These are application decisions, but unbuffered proxying makes them visible earlier in the request lifecycle.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A reliable test for “still buffering” reports

  1. Use a deliberately slow body source. Send a POST whose body is transmitted over a measurable interval rather than a request that completes immediately. A fast local test can hide buffering because the entire body arrives before you observe the upstream.
  2. Record timestamps in the upstream application. Log when the request is accepted and when the first body bytes are read. Client-side completion time alone cannot prove when NGINX forwarded data.
  3. Compare the first-byte and final-byte events. With effective request streaming, the upstream should observe body data before the client has finished sending it, subject to protocol framing and application read behavior.
  4. Confirm the selected location. Use nginx -T and inspect location precedence. A correct directive in an unused block produces the same symptom as a missing directive.
  5. Check the running version and proxy protocol. Look for the HTTP/2 version limitation and the HTTP/1.1 chunked-transfer caveat before changing buffer sizes.
  6. Inspect temporary-file activity. Large temporary files can indicate that request-body buffering is still active or that the client body is being handled by another module or location.
  7. Test response delivery separately. If the request reaches the application promptly but the response arrives in batches, investigate proxy_buffering; do not change request buffering to solve a response problem.

Common configuration mistakes and corrections

The directive is in the wrong location

A rule in one location does not affect a different location selected for the request. Put the setting in the block that actually handles the upload, or move it to a parent context only after checking all child blocks.

Only proxy_buffering off was added

This changes upstream-response handling and leaves request-body buffering unchanged. Add proxy_request_buffering off for the incoming POST body.

The file was edited but NGINX was not reloaded

Configuration files are not applied merely because they changed on disk. Run a syntax test, reload the service, and inspect the active configuration.

An old binary is running

Directive availability begins with NGINX 1.7.11, and HTTP/2 request-body buffering has the additional 1.9.14 boundary. Check the version of the running binary, not only the package version you intended to install.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A buffer-size change was expected to enable streaming

client_body_buffer_size affects memory and disk spill behavior. It does not replace proxy_request_buffering off.

The upstream never reads the body promptly

NGINX can forward bytes as received, but the application or upstream server may choose to read them later. Measure at the upstream with application or server logs before concluding that NGINX is buffering.

Operational checklist for production uploads

  • Scope proxy_request_buffering off to the endpoints that require streaming.
  • Confirm the running NGINX version is at least 1.7.11; use at least 1.9.14 when unbuffered HTTP/2 request bodies are required.
  • Check the protocol on the NGINX-to-upstream connection when clients use chunked transfer encoding.
  • Validate with nginx -t, inspect with nginx -T, and reload before testing.
  • Measure upstream first-byte and final-byte timings with a slow request body.
  • Review memory limits, request-body temporary-file storage, and cleanup of interrupted uploads.
  • Account for the loss of upstream failover after NGINX begins transmitting a request body.
  • Configure proxy_buffering off separately only when the upstream response also needs incremental delivery.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.