# Configuration

The format of this file is INI-style (name=value, divided into [sections]). Names are case insensitive. All values which are filenames can have shell-style tildes (~) in them. All values which are relative filenames are interpreted to be relative to the Pyzor homedir. All of these options can be overridden by command-line arguments.

It is recommended to use the provided sample configuration. Simply copy it in pyzor’s `homedir`, remove the `.sample` from the name and alter any configurations you prefer.

## client configuration

ServersFile
  Must contain a newline-separated list of server addresses to report/whitelist/check with. All of these server will be contacted for every operation. See Servers File.
AccountsFile
  File containing information about accounts on servers. See Accounts.
LogFile
  If this is empty then logging is done to stdout.
LocalWhitelist
  Specify the local whitelist file name.
Timeout
  This options specifies the number of seconds that the pyzor client should wait for a response from the server before timing out.
Style
  Specify the message input style. See Input Style.
ReportThreshold
  If the number of reports exceeds this threshold then the exit code of the pyzor client is 0.
WhitelistThreshold
  If the number of whitelists exceed this threshold then exit code of the pyzor client is 1.

## server configuration

Port
  Port to listen on.
ListenAddress
  Address to listen on.
LogFile
  File to contain server logs.
SentryDSN
  If set add a SentryHandler to the log file.
SentryLogLevel
  Set the log level for the SentryHandler. (default is `WARN`)
UsageLogFile
  File to contain server usage logs (information about each request).
UsageSentryDSN
  If set add a SentryHandler to the usage log file.
UsageSentryLogLevel
  Set the log level for the usage SentryHandler. (default is `WARN`)
PidFile
  This file contain the pid of the pyzord daemon when used with the –detach option.
PasswdFile
  File containing a list of user account information. See Accounts.
AccessFile
  File containing information about user privileges. See Access File.
Gevent
  If set to true uses the gevent library.
Engine
  Then engine type to be used for storage. See Engines.
DigestDB
  The database connection information. Format varies depending on the engine used. See Engines.
CleanupAge
  The maximum age of a record before it gets removed (in seconds). To disable this set to 0.
PreFork
  The number of workers the pyzor server should start. The server will pre-fork itself and split handling the requests among all workers. This is disabled by default.
Threads
  If set to true, the pyzor server will use multi-threading to serve requests.
MaxThreads
  The maximum number of concurrent threads (0 means unlimited).
DBConnections
  The number of database connections kept opened by the server (0 means a new one for each request).

Note

DBConnections only applies to the MySQL engine.

Processes
  If set to true, the pyzor server will use multi-processing to serve requests.
MaxProcesses
  The maximum number of concurrent processes (cannot be unlimited).