Chapter 5. Configuration

PowerSMTP and PowerPOP share many common configuration items. Prime among these are the userbase connection details and possible pplistener backend password details.

To enable easy configuration, both PowerSMTP and PowerPOP first parse power.conf, followed by powersmtp.conf and powerpop.conf respectively.

PPListener is different and does not need userbase configuration and therefore does not parse power.conf but only pplistener.conf.

5.1. All settings

Common to PowerSMTP and PowerPOP:

backends

Which backends to use for storing and retrieving messages. Syntax: group:priority:host. See Chapter 6 for details.

pplistener-password

Password to use when authenticating with PPListener backends.

config-name

Name of this virtual configuration. FIXME: write chapter on virtual configurations

listen-address

IP address to bind to. Defaults to 0.0.0.0 which means 'all interfaces'.

listen-port

Port to bind to. Defaults to 25 for PowerSMTP and to 110 for PowerPOP.

max-userbase-connections

Maximum number of simultaneous database connections to open. Multiple connections share a single connection, so there is no need to set this very high. Defaults to 3.

max-userbase-spares

A few userbase connections are kept on hand, even if they are not needed. This specifies how many spares can exist. If set to 0, connections will be opened and closed very often.

userbase

Which userbase to query for mailbox data. Defaults to 'mysqlplain'. See Chapter 10.

run-as-gid, run-as-uid

Credentials to switch to after acquiring priviledged ports.

daemon=[yes|no]

To run as a daemon or not. 'no' can be useful for debugging purposes.

PowerPOP and PowerSMTP also share userbase connection details for which see Chapter 10.