Callimachus sends email to new users when they are invited to establish an account.  Email is also necessary for Digest users to request lost passwords.  Configuring Callimachus to send email is therefore important to Callimachus configuration.

There are two ways to configure Callimachus to send email:

Configuring Mail Properties of a Server Connection

The Edit tab of a server connection is used (among other things) to modify the mail settings of the server. Modify the fields listed below to match your network and click Save settings.

Field Description Example
Mail connection type The type of Mail service that will be used by Callimachus. The options are STMP/TLS, STMPS, and SMTP.  SMTP/TLS
Host address The socket address of the mail server that will be used and the port on which it is accessible. Port 25 is common for SMTP, Port 465 is common for SMTPS. smtp.example.com:2525
From address The email address that will be used in the From section of email correspondence from Callimachus. joe@example.com
Authentication The email account and password used to connect to the mail server previously specified. joe@example.com, password

Providing a Local Mail Properties File

 Callimachus may be configured to send email by providing a local configuration file called etc/mail.properties under the Callimachus installation path.

The contents of the mail.properties file for a typical configuration looks like this:

mail.transport.protocol = smtp
mail.from = callimachus@example.com
mail.host = mail.example.com
mail.smtp.port = 25
mail.smtp.auth = true
mail.smtp.starttls.enable = true
mail.smtp.starttls.required = true
mail.user = callimachus
mail.password = secret

Where:

An example file for a configuration using encryption is:

mail.transport.protocol = smtps
mail.from = callimachus@example.com
mail.smtps.host = securemail.example.com
mail.smtps.port = 465
mail.smtps.auth = true
mail.user = callimachus
mail.password = secret