Start/notes.ini Parameters/HTTPMaxRequestBodySize

HTTPMaxRequestBodySize

🛠️
Parameter: HTTPMaxRequestBodySize
Short description: Maximum size (in bytes) of an HTTP request body – limits, among other things, file uploads in XPages, Verse, and the Domino REST API.

Profile

Parameter
HTTPMaxRequestBodySize
Category
HTTP / Web
Component
Server
Available since
10.0
Supported versions
10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI equivalent
Server document (Internet Protocols → HTTP)
Possible values
Bytes (e.g. 104857600 = 100 MB); 0 = no limit

Description

Protection against oversized HTTP POSTs (e.g. mass uploads via Verse attachments or REST endpoints). Anyone who sends a larger body receives a 413 Request Entity Too Large. For production Verse or Domino REST API servers, a value around 100–200 MB is typically set.

Example configuration

HTTPMaxRequestBodySize=104857600

Notes & pitfalls

  • Value in bytes – often incorrectly interpreted as KB/MB.
  • Pairs with HTTPMaxResponseBytes, HTTPMaxRequestsPerPersistentConnection, and reverse-proxy limits (e.g. nginx client_max_body_size).
  • If the value is too small, attachments in iNotes / Verse fail silently.
  • For pure API servers, deliberately keep it low (DoS protection).
  • The change takes effect after a restart of the HTTP task (tell http restart).