Options in lichen-config.php

SMTP server

$SMTP_SERVER

This is the outgoing SMTP server with which you send e-mail. If you're using a shared Web host, it'll probably be localhost.

$SMTP_DOMAIN

This is the domain name of your e-mail server as it appears to the Internet. Generally, you should set this manually to be the part after @ in your e-mail address. The default value is to auto-detect the domain of your Web server and assume your e-mail domain is the same, but this won't apply in all cases.

$SMTP_PORT

This is the port on which Lichen will connect to your SMTP server. If you use SMTP over SSL you'll need to set this to 465, and if you use Lichen on a home Internet connection you may need to set it to some value other than 25.

$SMTP_USE_SSL

If this is set to true, Lichen will use SSL when sending mail through your SMTP server.

$SMTP_AUTH

In most cases, SMTP servers require you to send your username and password before you can send mail. If your server doesn't require this, set $SMTP_AUTH to false. (If you're setting up an SMTP server and disable authentication, be careful not to create an  open relay.)

IMAP server

$IMAP_SERVER

This is the IMAP server that stores e-mail sent to you. If you're using a shared Web host, this will also probably be localhost.

$IMAP_PORT

If this value is non-zero, Lichen will connect to your IMAP server on this port. Otherwise, the port is automatically set to 993 for SSL connections and 143 for unencrypted connections.

$IMAP_FORCE_NO_SSL

If you set this to true, Lichen will not use SSL to connect to your IMAP server. If it's false, Lichen will automatically disable SSL for local connections, and enable it for non-local connections.

$IMAP_USE_TLS

If this is set to true, Lichen will encrypt all connections to the IMAP server with TLS, even to the local host. You should also set $IMAP_PORT (generally to 143) if you turn on TLS.

$IMAP_CHECK_CERTS

PHP's IMAP extension will check the trust level of encryption certificates by default if SSL or TLS are in use. Set this to false if you have a self-signed certificate (or just want to disable trust checking).

Data storage

$LICHEN_DATA

This is the directory that you chose for data storage in step 2 above. It's safer to enter a full path if you have it, but a path relative to the Lichen install will usually also work.

Date formats

$DATE_FORMAT_NEW

This is the  PHP date format string used for messages less than three days old, when displaying a list of messages in a mailbox. (Not used in version 0.3.)

$DATE_FORMAT_OLD

As above, used in the list for messages older than three days.

$DATE_FORMAT_LONG

The full date format used when you view the contents of a message.

User defaults override

$DEFAULT_SETTINGS

This array value allows you to override Lichen's default settings for new users, such as if you're running a large custom mail server. See the source of include/settings.inc.php for possible values to insert here.

Miscellaneous

$SPECIAL_FOLDERS

This array stores the names of the mailboxes that Lichen will use to save your sent messages, unsent drafts, and deleted messages, respectively.

$UPLOAD_ATTACHMENT_MAX

This value is inserted into the "compose new message" form as a hint to the browser indicating the maximum accepted size of uploaded files. However, it is a recommendation only -- the actual upload limits are set by the values in your server's  php.ini file.