CheckeredFlag Files

================================================================================
CheckeredFlag
================================================================================

This is a super simple mail server. The intended use is for local application
development that needs to be able to send email. CheckeredFlag runs on the local
machine and doesn't need a network connection nor any special set up. Just run
it and that is all.

There are a few others out there that are similar, but this one has a few nice 
differences:

1. It's super simple. Just 'java -jar CheckeredFlag.jar' and it's running. No
configuration, no extra stuff to install, no ISP mail accounts.

2. POP3 support. I suppose it's just POP support since all the nice features
of POP3 really aren't needed for this purpose, but it is more than sufficient
for testing your emails. This means you can connect any email client that 
supports POP3, and almost all of them do, including Outlook.

3. Doesn't need a network connection. This is nice for those situations like
when you're traveling and don't have internet. It's all contained on your
local machine so you can send and receive email all you want.

4. Webmail is built in. Just point your browser at CheckeredFlag, and see your
messages in a browser. Sweet!

5. Does not require a JDK, any JRE 1.7 or later should work fine.

6. There is no persistent mail storage. Once you stop CheckeredFlag, the messages
are lost. 

7. All smtp and pop3 command interaction can be shown in the CheckeredFlag output. 
This makes it easy to see exactly what your mail client is sending and receiving.

8. CheckeredFlag will accept email from any "From" address and to any "To" address.
However, there is only one mail box, so when you connect a POP3 client, you'll
get all messages sent to CheckeredFlag regardless of the addresses.

9. No SSL support. This helps keep CheckeredFlag super simple.

10. No username/password is necessary. Some email clients will whine, so fill
one in. It doesn't matter what they are, CheckeredFlag will ignore them.

11. While the intent is for CheckeredFlag to run on the same machine as the
development platform, it is certainly possible to run it on a dedicated
machine elsewhere on the network. In this way, several users can use the same
instance of CheckeredFlag.

================================================================================
Starting CheckeredFlag:
================================================================================

java -jar CheckeredFlag.jar

The name of the jar probably has a version number on it.

On start up you'll see this, which explains the configuration options, of
which there are only a few:

--------------------------------------------------------------------------------
> java -jar CheckeredFlag_1.0.0.jar 
CheckeredFlag starting.
Usage: java -jar CheckeredFlag.jar [smtp=xxxx] [web=xxxx] [pop3=xxxx] [no=web|pop3] [verbose]
	where xxxx is a port number. Default ports are:
	smtp: 25025
	web:  25080
	pop3: 25110
The 'no' parameter can be either 'web' or 'pop3' to indicate a server
 to NOT start.For example, 'no=pop3' will start the smtp and web mail
 servers, the pop3 server will not be started.

The 'verbose' parameter will show the complete conversation
 between the smtp server and client and the pop3 server and client.

CheckeredFlag starting, IP address: 10.6.11.121
SMTP server starting on port 25025...
SMTP listening on port 25025.
POP3 server starting on port 25110...
POP3 listening on port 25110.
Web mail server starting on port 25080...
Web mail listening on port 25080.

CheckeredFlag running, Ctrl-C to exit.

--------------------------------------------------------------------------------