Configure Apache James Server

All configuration files resides in the ./conf and ./conf/META-INF folder.

With default Spring wiring, we ship with default configuration. It gets automatically deployed in the conf folder while unzipping. Of course, you can change the files *.xml the settings to match your needs.

For Guice based wiring, you are encouraged to take a look at default configuration of the James docker images.

Please note that the configuration is dependent of the wiring you have chosen. Some configuration files are specific to some back-ends, to some protocols. Please also note that some configuration files are not required for Guice. In this case, it will be specified.

You can/must configure James for the following:

Config File Sample Config Area Config Comment
domainlist.xml Domain List Configuration
usersrepository.xml Users Configuration
recipientrewritetable.xml Recipient Rewrite Table Configuration
mailbox.xml Mailbox Configuration (Spring only)
mailbox.xml Quota Configuration (Spring only)
events.xml Event system Configuration (Spring only)
mailrepositorystore.xml Mail Repository Stores Configuration
dnsservice.xml DNS Service Configuration
smtpserver.xml SMTP Configuration
lmtpserver.xml LMTP Configuration
pop3server.xml POP3 Configuration
imapserver.xml IMAP4 Configuration
mailetcontainer.xml Mailet Container Configuration
fetchmail.xml FetchMail Configuration (Spring only)

For most advanced system configuration, you can configure James for the following:

System Config File Sample System Config Area System Config Comment
spring-server.xml System Configuration
james-database.properties System Configuration
META-INF/persistence.xml System Configuration
jmx.properties
System Configuration
log4j.properties See monitoring with log4j section.
sqlResources.xml System Configuration Deprecated
jcr-repository.xml System Configuration

See also more specific configurations related to TLS, Sieve and Antispam.