Start/notes.ini Parameters/SMTPDebug

SMTPDebug

🛠️
Parameter: SMTPDebug
Short description: Logs the full SMTP dialog (HELO/EHLO, MAIL FROM, RCPT TO, DATA) to the console / Debug_Outfile – the central tool for mail routing problems.

Profile

Parameter
SMTPDebug
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 = basic • 2 = verbose • 3 = with raw I/O

Description

SMTPDebug lets you turn up the logging of the SMTP task in a targeted way. For both incoming and outgoing connections, the protocol steps (connection setup, EHLO, AUTH, MAIL FROM, RCPT TO, DATA, termination) are logged to the console and/or to Debug_Outfile. Level 2 (verbose) is the typical troubleshooting value; level 3 additionally records the raw bytes, which is especially helpful for TLS or encoding issues.

Example configuration

SMTPDebug=2
Debug_Outfile=C:\\Domino\\IBM_TECHNICAL_SUPPORT\\smtp_debug.log

Notes & pitfalls

  • Performance impact: levels 2 / 3 produce a lot of output – enable in production only briefly and reset to 0 afterwards.
  • Takes effect after restart task smtp (or via the Configuration document).
  • The output may contain cleartext recipients and headers – mind data protection.
  • Complementary to RouterDebug, Console_Log_Enabled.