The build now works. To give M4 (HEAD) a try do this:
0. download JBoss 4.0.3SP1 with the EJB container/JDK5 stuff (or check it out from CVS and build with JDK 5, our JDK4 support has been dropped).
1. follow instructions for CVS here: http://wiki.jboss.org/wiki/Wiki.jsp?page=CVSRepository
2. cvs co jboss-mail
3. cd jboss-mail
4. ant clean dist
5. java -jar build/dist/install.jar
6. predominantly this (minor differences in screens/options): http://wiki.jboss.org/wiki/Wiki.jsp?page=HowToInstallJBossMailServer1.0M3
7. mailboxes are no longer created automatically and there is now a difference between a mailbox and a user. You must go to here: http://localhost:8080/jmx-console/HtmlAdaptor?action=inspectMBean&name=jboss.mail%3Atype%3DMailServices%2Cname%3DMailboxManager
and create a "mailbox" with an alias the same as your UserRepository user in order to read mail (this will be the user you will log on with in POP)
8. then get the ID of the mailbox (getMailboxIdByAlias())
9. Then create an alias for each SMTP address you want to allow (must also be listed in your "localdomain" list): andy@localhost.
localdomains: "localhost" "localhost.localdomain" "localdomain"
getMailboxIdByAlias("andy") == 2
would allow mails sent to "andy@localhost" to be delivered to the "andy" mailbox. However it would NOT allow mails to "email@example.com" to be delivered.
would allow that.
createAlias(2,"andy@localdomain") would be required for all 3 to make it there.
However when logging into POP you must put:
as "andy" is in the user repository with a password AND is keyed to the mailbox. If you put "andy@localhost" it will not work as there is no user called andy@localhost (only an alias).
What about SMTP:
mail to: <andy>
will fail because we do not allow mails to the null domain. (If anyone REALLY needs this we could add a "blank domain" feature but I'm betting you don't REALLY need this).
What about IP addresses?
If you want to allow folks to send to
<firstname.lastname@example.org>then you would have to add that as an alias and as a "localdomain". That's pretty retro though and I don't really like it.
I'm still doing some testing (there are reports of issues with Outlook which I'm about to test now). Once I'm done I'll cut M4-pre1 finally!!!!
So if that all looked complicated, read it this way: "There is now an easily installed email server that supports virtual hosting" ;-)
Once we make a GUI admin tool the mailbox thing will be less painful. I may add a simple servlet tool or something in the interim. I'm REALLY interested in seeing the GUI stuff start soon.