2008-02-14 10:41:02 -05:00
|
|
|
<?xml version="1.0"?>
|
2009-08-07 06:26:29 -04:00
|
|
|
<document xmlns="http://maven.apache.org/XDOC/2.0"
|
|
|
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
|
|
|
|
xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
|
2008-02-14 10:41:02 -05:00
|
|
|
|
|
|
|
|
<properties>
|
2010-07-26 12:10:37 -04:00
|
|
|
<title>DavMail POP/IMAP/SMTP/Caldav/Carddav/LDAP Exchange Gateway - Server setup</title>
|
2008-02-14 10:41:02 -05:00
|
|
|
<author email="mguessan@free.fr">Mickael Guessant</author>
|
|
|
|
|
</properties>
|
|
|
|
|
|
|
|
|
|
<body>
|
|
|
|
|
|
2008-10-28 18:00:59 -04:00
|
|
|
<section name="DavMail Setup as a standalone server">
|
2012-05-27 18:41:45 -04:00
|
|
|
<p>Prerequisite : Sun JRE 5, 6 or 7 or OpenJDK 6 or 7.
|
2008-02-14 10:41:02 -05:00
|
|
|
</p>
|
|
|
|
|
|
2010-08-26 04:39:38 -04:00
|
|
|
<p>Davmail Gateway can run in server mode as a gateway between the mail
|
2008-02-14 10:41:02 -05:00
|
|
|
client and the Outlook Web Access (Exchange) server.
|
2010-08-26 04:39:38 -04:00
|
|
|
In server mode Davmail can run on any Java supported platform.
|
2008-02-14 10:41:02 -05:00
|
|
|
This mode was tested successfully with the Iphone and should work with
|
2010-08-26 04:39:38 -04:00
|
|
|
any phone with POP/IMAP/SMTP/LDAP/Caldav/Carddav client.
|
|
|
|
|
In this mode many users can share the same DavMail instance.
|
2008-02-14 10:41:02 -05:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>Download the generic DavMail package from Sourceforge and uncompress it with
|
2010-08-26 04:39:38 -04:00
|
|
|
your favorite tool, e.g. on Linux: <code>unzip davmail-*.zip</code>.
|
2008-02-14 10:41:02 -05:00
|
|
|
</p>
|
2010-08-26 04:39:38 -04:00
|
|
|
<p>Prepare a davmail.properties file according to your local needs :
|
2008-02-14 10:41:02 -05:00
|
|
|
</p>
|
2010-08-29 12:16:27 -04:00
|
|
|
<source><![CDATA[
|
2013-05-11 16:08:37 -04:00
|
|
|
# DavMail settings, see http://davmail.sourceforge.net/ for documentation
|
|
|
|
|
|
|
|
|
|
#############################################################
|
|
|
|
|
# Basic settings
|
|
|
|
|
|
|
|
|
|
# Server or workstation mode
|
|
|
|
|
davmail.server=true
|
|
|
|
|
# connection mode auto, EWS or WebDav
|
|
|
|
|
davmail.enableEws=auto
|
|
|
|
|
# base Exchange OWA or EWS url
|
|
|
|
|
davmail.url=https://owa.example.com/owa/
|
|
|
|
|
|
|
|
|
|
# Listener ports
|
2010-08-29 12:16:27 -04:00
|
|
|
davmail.caldavPort=1080
|
2013-05-11 16:08:37 -04:00
|
|
|
davmail.imapPort=1143
|
2010-08-29 12:16:27 -04:00
|
|
|
davmail.ldapPort=1389
|
2013-05-11 16:08:37 -04:00
|
|
|
davmail.popPort=1110
|
|
|
|
|
davmail.smtpPort=1025
|
|
|
|
|
|
|
|
|
|
#############################################################
|
|
|
|
|
# Network settings
|
|
|
|
|
|
|
|
|
|
# Network proxy settings
|
2010-08-29 12:16:27 -04:00
|
|
|
davmail.enableProxy=false
|
2013-05-11 16:08:37 -04:00
|
|
|
davmail.useSystemProxies=false
|
2010-08-29 12:16:27 -04:00
|
|
|
davmail.proxyHost=
|
|
|
|
|
davmail.proxyPort=
|
|
|
|
|
davmail.proxyUser=
|
|
|
|
|
davmail.proxyPassword=
|
2013-05-11 16:08:37 -04:00
|
|
|
|
|
|
|
|
# proxy exclude list
|
2012-08-27 16:35:47 -04:00
|
|
|
davmail.noProxyFor=
|
2013-05-11 16:08:37 -04:00
|
|
|
|
|
|
|
|
# allow remote connection to DavMail
|
|
|
|
|
davmail.allowRemote=false
|
|
|
|
|
# bind server sockets to a specific address
|
|
|
|
|
davmail.bindAddress=
|
|
|
|
|
# client connections SO timeout in seconds
|
|
|
|
|
davmail.clientSoTimeout=
|
|
|
|
|
|
|
|
|
|
# DavMail listeners SSL configuration
|
|
|
|
|
davmail.ssl.keystoreType=
|
2010-08-29 12:16:27 -04:00
|
|
|
davmail.ssl.keystoreFile=
|
|
|
|
|
davmail.ssl.keystorePass=
|
2013-05-11 16:08:37 -04:00
|
|
|
davmail.ssl.keyPass=
|
|
|
|
|
|
|
|
|
|
# Accept specified certificate even if invalid according to trust store
|
2010-08-29 12:16:27 -04:00
|
|
|
davmail.server.certificate.hash=
|
2013-05-11 16:08:37 -04:00
|
|
|
|
|
|
|
|
# disable SSL for specified listeners
|
|
|
|
|
davmail.ssl.nosecurecaldav=false
|
|
|
|
|
davmail.ssl.nosecureimap=false
|
|
|
|
|
davmail.ssl.nosecureldap=false
|
|
|
|
|
davmail.ssl.nosecurepop=false
|
|
|
|
|
davmail.ssl.nosecuresmtp=false
|
|
|
|
|
|
|
|
|
|
# disable update check
|
|
|
|
|
davmail.disableUpdateCheck=true
|
|
|
|
|
|
2013-06-13 09:51:39 -04:00
|
|
|
# Send keepalive character during large folder and messages download
|
|
|
|
|
davmail.enableKeepalive=false
|
|
|
|
|
|
2013-05-11 16:08:37 -04:00
|
|
|
#############################################################
|
|
|
|
|
# Caldav settings
|
|
|
|
|
|
|
|
|
|
# override default alarm sound
|
|
|
|
|
davmail.caldavAlarmSound=
|
|
|
|
|
# retrieve calendar events not older than 90 days
|
|
|
|
|
davmail.caldavPastDelay=90
|
|
|
|
|
# WebDav only: force event update to trigger ActiveSync clients update
|
|
|
|
|
davmail.forceActiveSyncUpdate=false
|
|
|
|
|
|
|
|
|
|
#############################################################
|
|
|
|
|
# IMAP settings
|
|
|
|
|
|
|
|
|
|
# Delete messages immediately on IMAP STORE \Deleted flag
|
|
|
|
|
davmail.imapAutoExpunge=true
|
|
|
|
|
# Enable IDLE support, set polling delay in minutes
|
|
|
|
|
davmail.imapIdleDelay=
|
|
|
|
|
|
|
|
|
|
#############################################################
|
|
|
|
|
# POP settings
|
|
|
|
|
|
|
|
|
|
# Delete messages on server after 30 days
|
|
|
|
|
davmail.keepDelay=30
|
|
|
|
|
# Delete messages in server sent folder after 90 days
|
|
|
|
|
davmail.sentKeepDelay=90
|
|
|
|
|
# Mark retrieved messages read on server
|
|
|
|
|
davmail.popMarkReadOnRetr=false
|
|
|
|
|
|
|
|
|
|
#############################################################
|
|
|
|
|
# SMTP settings
|
|
|
|
|
|
|
|
|
|
# let Exchange save a copy of sent messages in Sent folder
|
|
|
|
|
davmail.smtpSaveInSent=true
|
|
|
|
|
|
|
|
|
|
#############################################################
|
|
|
|
|
# Loggings settings
|
|
|
|
|
|
|
|
|
|
# log file path, leave empty for default path
|
|
|
|
|
davmail.logFilePath=/var/log/davmail.log
|
|
|
|
|
# maximum log file size, use Log4J syntax, set to 0 to use an external rotation mechanism, e.g. logrotate
|
|
|
|
|
davmail.logFileSize=1MB
|
|
|
|
|
# log levels
|
|
|
|
|
log4j.logger.davmail=WARN
|
2010-08-29 12:16:27 -04:00
|
|
|
log4j.logger.httpclient.wire=WARN
|
2013-05-11 16:08:37 -04:00
|
|
|
log4j.logger.org.apache.commons.httpclient=WARN
|
|
|
|
|
log4j.rootLogger=WARN
|
|
|
|
|
|
|
|
|
|
#############################################################
|
|
|
|
|
# Workstation only settings
|
|
|
|
|
|
|
|
|
|
# smartcard access settings
|
|
|
|
|
davmail.ssl.pkcs11Config=
|
|
|
|
|
davmail.ssl.pkcs11Library=
|
|
|
|
|
|
|
|
|
|
# SSL settings for mutual authentication
|
|
|
|
|
davmail.ssl.clientKeystoreType=
|
|
|
|
|
davmail.ssl.clientKeystoreFile=
|
|
|
|
|
davmail.ssl.clientKeystorePass=
|
|
|
|
|
|
|
|
|
|
# disable all balloon notifications
|
|
|
|
|
davmail.disableGuiNotifications=false
|
|
|
|
|
# disable startup balloon notifications
|
|
|
|
|
davmail.showStartupBanner=true
|
|
|
|
|
|
|
|
|
|
# enable transparent client Kerberos authentication
|
|
|
|
|
davmail.enableKerberos=false]]>
|
2008-02-14 10:41:02 -05:00
|
|
|
</source>
|
|
|
|
|
<p>See
|
|
|
|
|
<a href="gettingstarted.html">Getting started</a>
|
|
|
|
|
for more information on
|
|
|
|
|
the options. Make sure davmail.server is set to true (no icon tray) and allow
|
|
|
|
|
remote connections: davmail.allowRemote=true.
|
|
|
|
|
</p>
|
2009-02-12 09:32:40 -05:00
|
|
|
<p>To disable a service, set an empty port value.</p>
|
2008-02-14 10:41:02 -05:00
|
|
|
<p>Launch Davmail with the following command:
|
|
|
|
|
<source>nohup davmail.sh davmail.properties &</source>.
|
|
|
|
|
</p>
|
|
|
|
|
<p>Then check messages:
|
|
|
|
|
<source>tail -f nohup.out</source>
|
|
|
|
|
</p>
|
2008-10-28 18:00:59 -04:00
|
|
|
</section>
|
|
|
|
|
|
2010-02-18 16:27:08 -05:00
|
|
|
<section name="Register DavMail windows service">
|
2012-04-23 17:47:54 -04:00
|
|
|
<p>A new WinRun4J davmailservice.exe wrapper is available in the windows
|
2010-02-18 16:27:08 -05:00
|
|
|
package.
|
|
|
|
|
</p>
|
|
|
|
|
<p>To register DavMail as a windows service, use:
|
2012-04-23 17:47:54 -04:00
|
|
|
<source>davmailservice --WinRun4J:RegisterService</source>
|
2010-02-18 16:27:08 -05:00
|
|
|
or
|
|
|
|
|
<source>sc create DavMail binPath= \path\to\davmailservice.exe type= own start= auto</source>
|
|
|
|
|
</p>
|
|
|
|
|
</section>
|
|
|
|
|
|
2013-07-17 18:26:26 -04:00
|
|
|
<section name="OSX LaunchDaemon">
|
|
|
|
|
<p>To launch DavMail on OSX with LaunchDaemon, you may try the following user provided script:</p>
|
|
|
|
|
<source><![CDATA[[<?xml version="1.0" encoding="UTF-8"?>
|
|
|
|
|
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
|
|
|
|
<plist version="1.0">
|
|
|
|
|
<dict>
|
|
|
|
|
<key>Label</key>
|
|
|
|
|
<string>davmail</string>
|
|
|
|
|
<key>RunAtLoad</key>
|
|
|
|
|
<true/>
|
|
|
|
|
<key>ProgramArguments</key>
|
|
|
|
|
<array>
|
|
|
|
|
<string>/usr/libexec/davmail/davmail.sh</string>
|
|
|
|
|
<string>/usr/libexec/davmail/davmail.properties</string>
|
|
|
|
|
</array>
|
|
|
|
|
</dict>
|
|
|
|
|
</plist>]]></source>
|
|
|
|
|
</section>
|
|
|
|
|
|
2008-10-28 18:00:59 -04:00
|
|
|
<section name="DavMail Setup as a JEE Web Application">
|
2012-05-27 18:41:45 -04:00
|
|
|
<p>Prerequisites : Sun JRE 5, 6 or 7 or OpenJDK 6 or 7 and any JEE compliant web container
|
2008-10-28 18:00:59 -04:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>Davmail Gateway can now be deployed in any JEE application server using
|
|
|
|
|
the war package. In this mode, DavMail listener threads run inside the
|
|
|
|
|
application server and follow the web application lifecycle (start,
|
|
|
|
|
stop, deploy, undeploy). The following items describe Tomcat deployment,
|
|
|
|
|
details will vary according to the specific application server available.
|
|
|
|
|
</p>
|
|
|
|
|
|
2009-08-07 06:26:29 -04:00
|
|
|
<p>Download the war DavMail package from Sourceforge<code>davmail-*.war</code>,
|
2008-10-28 18:00:59 -04:00
|
|
|
and deploy it inside the application server. In Tomcat, this means copy the
|
|
|
|
|
war file to the webapps directory. If Tomcat is started and automatic
|
|
|
|
|
deployment enabled (this is the default configuration), the package is
|
|
|
|
|
automatically uncompressed and started.
|
|
|
|
|
</p>
|
|
|
|
|
<p>The davmail.properties configuration file is then available under
|
|
|
|
|
<code>davmail-*/WEB-INF/classes</code>.
|
|
|
|
|
</p>
|
2009-08-07 06:26:29 -04:00
|
|
|
|
2010-12-09 16:22:44 -05:00
|
|
|
<p>Note: DavMail does not use the standard Tomcat HTTP connector and uses the same listeners
|
|
|
|
|
in war and server modes. This means the HTTP port for Caldav url is specified in davmail.properties
|
|
|
|
|
</p>
|
|
|
|
|
|
2008-10-28 18:00:59 -04:00
|
|
|
<p>See above and
|
2008-02-14 10:41:02 -05:00
|
|
|
<a href="gettingstarted.html">Getting started</a>
|
2008-10-28 18:00:59 -04:00
|
|
|
for more information on
|
|
|
|
|
the options. Make sure davmail.server is set to true (no icon tray) and allow
|
|
|
|
|
remote connections: davmail.allowRemote=true.
|
2008-02-14 10:41:02 -05:00
|
|
|
</p>
|
|
|
|
|
</section>
|
|
|
|
|
</body>
|
|
|
|
|
</document>
|
