Download and install

To start with the Mercury first download the latest binary package from here.

Next step is to create a folder and unzip downloaded package in it.

Run

Now you can run it with:

sh bin/start.sh

Explore

Next step is to explore "bean-console":

http://localhost:8080/bean-console

In bean console go to "DeploymentManager", then "deployedModules" and follow "mercury-mail-suite" and at the end "mercury.StorageManager". After that you will be on the url:

http://localhost:8080/bean-console/[DeploymentManager]/deployedModules/[mercury-mail-suite]/[mercury.StorageManager].

(You can get there as well just by clicking the link above)

In "StorageManager" you can:

• set your main domain name ("mainDomain" property);
• add more domains this smtp server will accept e-mails for ("addDomain()" method);
• add mailbox ("addMailbox()" method
• or add alias to existing mailbox ("addAlias()" method

Note: don't forget to call "save" method after properties changes. Adding mailbox/alias does it automatically

Use

Now you can set up your mail client to send e-mail to smpt server "localhost" at port 8025. Don't forget that only e-mails to defined mailboxes will be delivered. Others will be quietly discarded. See documentation for more details. Also, you can set up same mail client to use "localhost" for IMAP server at port number 8143. Remember to use just mailbox name a account's username along with specified password.

Places of Interest

Places of interest are:

• http://localhost:8080/bean-console/[DeploymentManager]/deployedModules/[mercury-mail-suite]/[mercury.imap.LoggingConnectionHandler] - change "addressPattern" to ".*" and "logging" to "true" and you will see logs for IMAP in "server/default/deploy/mercury-logs/logs". Same is with http://localhost:8080/bean-console/[DeploymentManager]/deployedModules/[mercury-mail-suite]/[mercury.smtp.LoggingConnectionHandler]
• http://localhost:8080/bean-console/[DeploymentManager]/deployedModules/[mercury-mail-suite]/[mercury.smtp.AccessLoggerConnectionHandler] and http://localhost:8080/bean-console/[DeploymentManager]/deployedModules/[mercury-mail-suite]/[mercury.imap.AccessLoggerConnectionHandler] to set access log patterns. You can consult JavaDocs for codes: SMTPSPAMPatternProcessor and AccessLogConnectionHandler. Access logs can be found in "server/default/deploy/mercury-logs/access". Note: changes here are only temporary until server is restarted. For permanent changes see config files in "server/default/deploy/mercury-mail-suite/".
• Folder: "server/default/deploy/mercury-data/" contains "config" and "mailboxes" sub-folders. First contains configuration property file and keystore for passwords while second contains sub-folders of domains with folders with accounts. Folders of accounts are in Maildir format, so, theoretically, they can be read directly by some other programs that recognise Maildir format, although that is not recommended.
• Folder "server/default/deploy/mercury-mail-suite/" contains three Spring framework xml files. They have definitions of server, addresses, ports, logging, etc. STMP config file has commended out section that contains definition of Finger invocation as some providers allow you to invoke finger command in order to fetch all "missed" e-mails.
• Consult documentation of Danube and Extend for setting up security around HTTP server and "bean-console".
• Interesting but currently not fully implemented is WEB-DAV access to "bean-console" through:
  
  http://localhost:8080/bean-webdav.
  
  Beans are defined as folders and properties as files. You can do something like:
  
  cat folderYouMountedBeanWebdav/[DeploymentManager]/deployedModules/[mercury-mail-suite]/[mercury.smtp.LoggingConnectionHandler]
  
  to display logging pattern for SMTP server. Writing to the file works as well: echo >folderYouMountedBeanWebdav/[DeploymentManager]/deployedModules/[mercury-mail-suite]/[mercury.smtp.LoggingConnectionHandler] ".*"