ERPNextCalc Nginx Reverse Proxy & Static Asset Architecture

ERPNextCalc Static File Offloading & Gzip Compression

Frappe bench compiles Desk JavaScript and CSS bundles into sites/assets/. Configuring Nginx with try_files and 30-day immutable cache headers keeps Gunicorn reserved strictly for dynamic /api/method and Desk RPC calls.

We recommend setting client_max_body_size 50m so manufacturing CAD drawings and scanned vendor invoices upload without 413 Request Entity Too Large errors.

ERPNextCalc Upstream Keepalive & Buffer Settings

Enabling proxy_buffer_size 128k and proxy_buffers 4 256k prevents Nginx from spilling large JSON report payloads to temporary disk files under /var/lib/nginx.

We advise keeping Nginx worker_processes auto with 1,024 worker_connections, consuming under 128 MB of host RAM.

ERPNextCalc Nginx Upstream & Timeout Snippet

upstream frappe-bench-frappe { server 127.0.0.1:8000 fail_timeout=0; }
upstream frappe-bench-socketio-server { server 127.0.0.1:9000 fail_timeout=0; }
# Match http_timeout in common_site_config.json
proxy_read_timeout 120;
client_max_body_size 50m;

Synchronizing Nginx timeouts with ERPNextCalc Gunicorn settings removes mysterious 504 errors during month-end financial close.

Use the ERPNextCalc Config Studio to copy matching http_timeout values into your bench configuration.