QuickStart

Overview

There are currently two ways of getting this application up and running:

• Building it yourself, and installing it in a Java web container (such as Tomcat).
• Downloading the pre-built war file and installing it in a Java web container.

Future plans

• Provide an executable jar file that contains it's own web container
• (Possibly) provide a binary executable that can be run directly.

Building

Mini-mailinator is a Maven project. Please ensure you have Maven installed before attempting to build this application.

Check out the source code using anonymous SVN access.

From within the directory you just checked out, run

mvn clean install

A new WAR file will be created in:

target/mini-mailinator.war

Installing

Copy the mini-mailinator.war file to your web container's webapps directory and you should be good to go.

Logging

The application is currently very verbose. This can be changed by modifying the logging configuration file:

src/main/resources/log4j.xml

The line you might want to change is:

<priority value="info"/>

Change that from INFO to WARN and logging levels will be decreased substantially.

As I do not know what container you are working in, or what directory structures you want to use, I have defaulted to logging to STDOUT. You might want to change this. There is a sample RollingFileAppender in the log4j.xml that you can reconfigure as needed.

Configuring your application

Note: Here I am talking about your application, not the mini-mailinator program.

All you need do is set up your application to point to the IP address of your web container, and port 2525. Authentication is not needed, and will be ignored if you try to provide it.

As an example:

SMTP Server:                         localhost
SMTP Port:                           2525
SMTP Server requires authorization?  No
Requires SSL?                        No

Viewing emails

Point your web browser to your web container, with the context of "mini-mailinator". For example:

http://localhost:8080/mini-mailinator/

You should see a relatively simple web interface suitable for browsing emails sent to your web server.