Start/notes.ini Parameters/SMTPListenerEnabled

SMTPListenerEnabled

🛠️
Parameter: SMTPListenerEnabled
Short description: Enables or disables the inbound SMTP listener as an override to the Server document – useful for emergency shutdowns or cluster-specific configurations.

Profile

Parameter
SMTPListenerEnabled
Category
Mail / Router
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
Possible values
0 = SMTP listener off • 1 = enabled

Description

Normally the inbound SMTP listener is enabled via the Server document (“SMTP listener task”). SMTPListenerEnabled in notes.ini acts as an override to the Server document: a value of 0 turns the listener off on this server regardless of the directory configuration. This is helpful when a server should temporarily stop accepting external mail (maintenance window, antispam incident, migration) without having to replicate a directory change everywhere. In cluster setups it also allows targeting only one node as the mail inbound point.

Example configuration

SMTPListenerEnabled=1

Notes & pitfalls

  • The override beats the Server document – changes there have no effect while SMTPListenerEnabled is set.
  • Takes effect after restart task smtp.
  • For permanent configuration, manage this in the Server document; use the notes.ini override only for exceptions.
  • Counterpart to SMTPListenerPort.