Sign in
latestOpenAPI 3.0.2cPanel License2026-08-106251554.3 MB

3da41671c02c

Mail
Spam Management

Update Apache SpamAssassin™ configuration

This function configures your Apache SpamAssassin™ options.

Important:

When you disable the Spam Filter role, the system disables this function.

get/save_spamd_config

Query parameters

allowedipsstring
Example:127.0.0.1,192.168.0.1

A comma-separated list of IP addresses to authorize to access the spamd daemon.

Note:

  • If you do not specify a value, the spamd daemon allows connections from any IP address.
  • If you set a value for this parameter, it must include 127.0.0.1 in the list of values so that the chkservd daemon can access the spamd daemon.
maxchildreninteger
Example:5

The maximum number of children per spamd process.

maxconnperchildinteger
Example:200

The maximum number of connections that the spamd daemon allows per child process.

pidfilestring
Example:/var/run/spamd.pid

The process ID's file path.

Warning:

This parameter changes the spamd daemon's process ID filepath. On systems that use the systemd daemon, you must update the PIDFile parameter in the spamd.service definition. If you do not update the PIDFile parameter, the spamd daemon will fail to function because the PID path and the PIDFile parameter will not match.

timeoutchildinteger
Example:300

The maximum amount of time that a child process waits before it abandons a TCP connection.

Note:

If the value of this parameter is 0, child processes will not abandon TCP connections.

timeouttcpinteger
Example:30

The maximum amount of time that the spamd daemon waits before it abandons a TCP connection.

Note:

If the value of this parameter is 0, spamd will not abandon TCP connections.

Response

HTTP Request was successful.

Example response

{
  "metadata": {
    "command": "save_spamd_config",
    "reason": "OK",
    "result": 1,
    "version": 1
  }
}