Start/notes.ini Parameters/DEBUG_HTTPINOUT

DEBUG_HTTPINOUT

🛠️
Parameter: DEBUG_HTTPINOUT
Short description: Writes incoming HTTP request and outgoing response headers to the Debug_Outfile – the basis for analyzing reverse proxy, XPages, and Verse issues.

Profile

Parameter
DEBUG_HTTPINOUT
Category
Logging / Debug
Component
Server
Available since
10.0
Supported versions
10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI equivalent
notes.ini only (no GUI)
Possible values
0 = off, 1 = headers, 2 = headers + body excerpt

Description

When HTTP requests unexpectedly lead to 401, 404, or 500, it's usually unclear what the reverse proxy actually forwards to Domino. DEBUG_HTTPINOUT shows every received request with all headers (including Authorization, Cookie, X-Forwarded-*) as well as the response headers. At level 2, an excerpt of the body is additionally logged.

Example configuration

DEBUG_HTTPINOUT=1
Debug_Outfile=/local/notesdata/IBM_TECHNICAL_SUPPORT/http_inout.log

Notes & pitfalls

  • Do not leave permanently enabled – sensitive headers (cookies, tokens) end up in clear text in the log.
  • Level 2 produces very large logs (body excerpt per request).
  • Complements DEBUG_HTTP_RESPONSE, DEBUG_TLS, DEBUG_OIDC*.
  • Securely dispose of logs after diagnosis or at least redact them before passing to third parties.
  • Takes effect immediately after set config DEBUG_HTTPINOUT=... – restart not required.