diff --git a/src/site/site.xml b/src/site/site.xml index b7835e9b..30c5d393 100644 --- a/src/site/site.xml +++ b/src/site/site.xml @@ -41,6 +41,7 @@ + diff --git a/src/site/xdoc/advanced.xml b/src/site/xdoc/advanced.xml new file mode 100644 index 00000000..c816107c --- /dev/null +++ b/src/site/xdoc/advanced.xml @@ -0,0 +1,232 @@ + + + + + DavMail POP/IMAP/SMTP/Caldav/Carddav/LDAP Exchange Gateway - Advanced settings + Mickael Guessant + + + + +
+

In addition to basic settings described in + Getting started + DavMail also supports the following settings: +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionSample value
Enable EWSEnable EWS mode on Exchange 2010 or Exchange 2007 with Webdav disabledfalse
Default domainDefault windows domain nameDOMAIN
Display startup bannerWhether to show the initial startup notification window or nottrue
Disable update checkDisable DavMail check for new versionfalse
+
+ + + + + + + + + + + + + + + + + +
ParameterDescriptionSample value
Allow remote connectionsAllow remote connections to the gateway (server mode)false
Bind AddressBind only to the specified network address, leave empty to listen on all network + interfaces + 10.0.1.2
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionSample value
Server certificate hashManually accepted server certificate hash, contains the SHA1 hash of + a manually accepted certificate (invalid or self signed) + 9F:CC:59:82:1F:C:CD:29:7C:70:F0:D8:37:B1:77:3F:48:84:AE:C4
Key store typeTo encrypt communication between client and DavMail, create a server certificate, + choose key store type and set key store path + JKS
Key storeSSL certificate key store file pathpath/to/keystore
Key store passwordKey store passwordpassword
Key passwordSSL key password inside key storepassword
Client key store typeWhen the Exchange server requires mutual authentication, + choose client certificate key store type, PKCS11 for smartcard, + PKCS12 or JKS for certificate file + PKCS11
Client key storeSSL client certificate key store file pathpath/to/keystore
Client key store passwordClient key store password, leave empty for runtime promptpassword
PKCS11 libraryPKCS11 (smartcard) library path (.so or .dll)softokn3.dll
PKCS11 configOptional additional PKCS11 settings (slot, nssArgs, ...)slot=2
+
+ + + + + + + + + + + + + + + + + +
ParameterDescriptionSample value
Keep Delay (POP)Number of days to keep messages in Exchange trash folder before actual deletion, + only for POP service + 30
Sent Keep Delay (POP)Number of days to keep sent messages in Exchange sent folder, + only for POP service + 90
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionSample value
Calendar past events (Caldav)Get events in the past not older than specified days count, leave empty for no limits90
Edit Caldav notificationsEnable interactive Caldav edit notification windowfalse
Force Active Sync updateUse double event update to trigger ActiveSync mobile phones sync, only in WebDav modefalse
Caldav alarm soundConvert Caldav alarm to sound alarm supported by iCal, e.g. Basso. Leave empty for no + conversion + Basso
+
+ + + + + + + + + + + + + + + + + +
ParameterDescriptionSample value
IDLE folder monitor delay (IMAP):IMAP folder idle monitor delay in minutes, leave empty to disable IDLE support1
IMAP auto expungeDelete messages immediately on the server over IMAPtrue
+
+ + + + + + + + + + + + + + + + + +
ParameterDescriptionSample value
Logging levelsDefault, DavMail and HttpClient logging levels, see Log4J documentation for more details + WARN
Log file PathDavMail log file path (default is davmail.log in working directory on Unix and Windows, + ~/Library/Logs/DavMail/davmail.log on OSX) + davmail.log
+
+
+ + +
\ No newline at end of file diff --git a/src/site/xdoc/gettingstarted.xml b/src/site/xdoc/gettingstarted.xml index b11ce1be..86dbe8aa 100644 --- a/src/site/xdoc/gettingstarted.xml +++ b/src/site/xdoc/gettingstarted.xml @@ -18,7 +18,7 @@
-

The following table describes the main and advanced options :

+

The following table describes the main options :

@@ -58,154 +58,10 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ParameterLocal LDAP server port to configure in directory (address book) client 389
Keep Delay (POP)Number of days to keep messages in Exchange trash folder before actual deletion, - only for POP service - 30
Sent Keep Delay (POP)Number of days to keep sent messages in Exchange sent folder, - only for POP service90
Calendar past events (Caldav)Get events in the past not older than specified days count, leave empty for no limits90
IDLE folder monitor delay (IMAP):IMAP folder idle monitor delay in minutes, leave empty to disable IDLE support1
Allow remote connectionsAllow remote connections to the gateway (server mode)false
Edit Caldav notificationsEnable interactive Caldav edit notification windowfalse
Force Active Sync updateUse double event update to trigger ActiveSync mobile phones syncfalse
IMAP auto expungeDelete messages immediately on the server over IMAPtrue
Enable EWSEnable EWS mode on Exchange 2010 or Exchange 2007 with Webdav disabledfalse
Display startup bannerWhether to show the initial startup notification window or nottrue
Caldav alarm soundConvert Caldav alarm to sound alarm supported by iCal, e.g. Basso. Leave empty for no - conversion - Basso
Default domainDefault windows domain nameDOMAIN
Key store typeTo encrypt communication between client and DavMail, create a server certificate, - choose key store type and set key store path - JKS
Key storeSSL certificate key store file pathpath/to/keystore
Key store passwordKey store passwordpassword
Key passwordSSL key password inside key storepassword
Client key store typeWhen the Exchange server requires mutual authentication, - choose client certificate key store type, PKCS11 for smartcard, - PKCS12 or JKS for certificate file - PKCS11
Client key storeSSL client certificate key store file pathpath/to/keystore
Client key store passwordClient key store password, leave empty for runtime promptpassword
PKCS11 libraryPKCS11 (smartcard) library path (.so or .dll)softokn3.dll
PKCS11 configOptional additional PKCS11 settings (slot, nssArgs, ...)slot=2
Bind AddressBind only to the specified network address10.0.1.2
Server certificate hashManually accepted server certificate hash, contains the SHA1 hash of - a manually accepted certificate (invalid or self signed) - 9F:CC:59:82:1F:C:CD:29:7C:70:F0:D8:37:B1:77:3F:48:84:AE:C4
Disable update checkDisable DavMail check for new versionfalse
Logging levelsDefault, DavMail and HttpClient logging levels, see Log4J documentation for more details - WARN
Log file PathDavMail log file path (default is davmail.log in working directory on Unix and Windows, - ~/Library/Logs/DavMail/davmail.log on OSX) - davmail.log

Uncheck a port to disable matching service.

Activate panel under Proxy tab to set an HTTP proxy and associated credentials if needed

+

If you need to adjust other advanced settings, check Advanced settings

Proceed to Thunderbird mail setup or diff --git a/src/site/xdoc/iphonecaldavsetup.xml b/src/site/xdoc/iphonecaldavsetup.xml index f9ad7aa4..ddcd5780 100644 --- a/src/site/xdoc/iphonecaldavsetup.xml +++ b/src/site/xdoc/iphonecaldavsetup.xml @@ -1,67 +1,67 @@ - - - - - DavMail POP/IMAP/SMTP/Caldav/Carddav/LDAP Exchange Gateway - iPhone Caldav setup - Mickael Guessant - - - - -

-

Note: you can't install DavMail directly on an iPhone, you need a separate DavMail server, - seeiPhone setup. -

- - -

Open iPhone Settings application and choose Mail, Contacts, Calendar: -

-
- -
- -

Then select Add Account...: -

-
- -
- -

DavMail is not an Exchange ActiveSync server, press Other: -

-
- -
- -

Choose Add CalDAV Account: -

-
- -
- -

Enter your DavMail server hostname in the Server field, - append ':' and port if DavMail HTTP (Caldav and Carddav) port is not 80, - provide your username and password then press Next: -

-
- -
- -

On the account page, open Advanced Settings: -

-
- -
- -

Enable SSL and check port, make sure Account URL is - https://davmailhost:1080/principals/users/username@ompany.com: -

-
- -
- -
-
- + + + + + DavMail POP/IMAP/SMTP/Caldav/Carddav/LDAP Exchange Gateway - iPhone Caldav setup + Mickael Guessant + + + + +
+

Note: you can't install DavMail directly on an iPhone, you need a separate DavMail server, + see iPhone setup. +

+ + +

Open iPhone Settings application and choose Mail, Contacts, Calendar: +

+
+ +
+ +

Then select Add Account...: +

+
+ +
+ +

DavMail is not an Exchange ActiveSync server, press Other: +

+
+ +
+ +

Choose Add CalDAV Account: +

+
+ +
+ +

Enter your DavMail server hostname in the Server field, + append ':' and port if DavMail HTTP (Caldav and Carddav) port is not 80, + provide your username and password then press Next: +

+
+ +
+ +

On the account page, open Advanced Settings: +

+
+ +
+ +

Enable SSL and check port, make sure Account URL is + https://davmailhost:1080/principals/users/username@company.com: +

+
+ +
+ +
+
+
\ No newline at end of file diff --git a/src/site/xdoc/iphonecarddavsetup.xml b/src/site/xdoc/iphonecarddavsetup.xml index e503da0b..3d7ed534 100644 --- a/src/site/xdoc/iphonecarddavsetup.xml +++ b/src/site/xdoc/iphonecarddavsetup.xml @@ -1,69 +1,69 @@ - - - - - DavMail POP/IMAP/SMTP/Caldav/Carddav/LDAP Exchange Gateway - iPhone Carddav setup - Mickael Guessant - - - - -
-

Note: you can't install DavMail directly on an iPhone, you need a separate DavMail server, - seeiPhone setup. -

- - -

Open iPhone Settings application and choose Mail, Contacts, Calendar: -

-
- -
- -

Then select Add Account...: -

-
- -
- -

DavMail is not an Exchange ActiveSync server, press Other: -

-
- -
- -

Choose Add CardDAV Account: -

-
- -
- -

Enter your DavMail server hostname in the Server field, - append ':' and port if DavMail HTTP (Caldav and Carddav) port is not 80, - provide your username and password then press Next: -

-
- -
- -

On the account page, open Advanced Settings: -

-
- -
- -

Enable SSL and check port: -

-
- -
- -

Contact setup is complete, proceed to - iPhone Caldav setup -

-
-
- + + + + + DavMail POP/IMAP/SMTP/Caldav/Carddav/LDAP Exchange Gateway - iPhone Carddav setup + Mickael Guessant + + + + +
+

Note: you can't install DavMail directly on an iPhone, you need a separate DavMail server, + see iPhone setup. +

+ + +

Open iPhone Settings application and choose Mail, Contacts, Calendar: +

+
+ +
+ +

Then select Add Account...: +

+
+ +
+ +

DavMail is not an Exchange ActiveSync server, press Other: +

+
+ +
+ +

Choose Add CardDAV Account: +

+
+ +
+ +

Enter your DavMail server hostname in the Server field, + append ':' and port if DavMail HTTP (Caldav and Carddav) port is not 80, + provide your username and password then press Next: +

+
+ +
+ +

On the account page, open Advanced Settings: +

+
+ +
+ +

Enable SSL and check port: +

+
+ +
+ +

Contact setup is complete, proceed to + iPhone Caldav setup +

+
+
+
\ No newline at end of file diff --git a/src/site/xdoc/iphonemailsetup.xml b/src/site/xdoc/iphonemailsetup.xml index 18b07f6b..10145b78 100644 --- a/src/site/xdoc/iphonemailsetup.xml +++ b/src/site/xdoc/iphonemailsetup.xml @@ -1,145 +1,145 @@ - - - - - DavMail POP/IMAP/SMTP/Caldav/Carddav/LDAP Exchange Gateway - iPhone Mail setup - Mickael Guessant - - - - -
-

Note: you can't install DavMail directly on an iPhone, you need a separate DavMail server, - seeiPhone setup. -

- - -

Open iPhone Settings application and choose Mail, Contacts, Calendar: -

-
- -
- -

Then select Add Account...: -

-
- -
- -

DavMail is not an Exchange ActiveSync server, press Other: -

-
- -
- -

Choose Add Mail Account: -

-
- -
- -

Enter your name, email address and password, then press Next: -

-
- -
- -

Select IMAP account type: -

-
- -
- -

In Incoming Mail Server section, enter your DavMail server hostname, - append ':' and port if DavMail IMAP port is not 143: -

-
- -
- -

In Outgoing Mail Server section, enter your DavMail server hostname, - do not append port, this is not supported by current iOS version, then press Next: -

-
- -
- -

Wait until your iPhone has finished verifying all possible port/protocol combination: -

-
- -
- -

If you get the - Cannot Connect Using SSL - message, just select Yes, - you will just need to adjust account settings later. -

-
- -
- -

Save the account: -

-
- -
- -

Confirm: -

-
- -
- -

Back to account settings page, still need to fix SMTP port - if DavMail is not listening on default port 25, - open account settings: -

-
- -
- -

Open Account Info: -

-
- -
-

Open SMTP page: -

-
- -
-

Choose primary server: -

-
- -
-

Adjust SMTP port: -

-
- -
-

Back to Account Info, open Advanced settings: -

-
- -
-

Back to Account Info, open Advanced settings: -

-
- -
-

Enable SSL on IMAP port: -

-
- -
-

Mail setup is complete, proceed to - iPhone Carddav setup -

-
-
- + + + + + DavMail POP/IMAP/SMTP/Caldav/Carddav/LDAP Exchange Gateway - iPhone Mail setup + Mickael Guessant + + + + +
+

Note: you can't install DavMail directly on an iPhone, you need a separate DavMail server, + see iPhone setup. +

+ + +

Open iPhone Settings application and choose Mail, Contacts, Calendar: +

+
+ +
+ +

Then select Add Account...: +

+
+ +
+ +

DavMail is not an Exchange ActiveSync server, press Other: +

+
+ +
+ +

Choose Add Mail Account: +

+
+ +
+ +

Enter your name, email address and password, then press Next: +

+
+ +
+ +

Select IMAP account type: +

+
+ +
+ +

In Incoming Mail Server section, enter your DavMail server hostname, + append ':' and port if DavMail IMAP port is not 143: +

+
+ +
+ +

In Outgoing Mail Server section, enter your DavMail server hostname, + do not append port, this is not supported by current iOS version, then press Next: +

+
+ +
+ +

Wait until your iPhone has finished verifying all possible port/protocol combination: +

+
+ +
+ +

If you get the + Cannot Connect Using SSL + message, just select Yes, + you will just need to adjust account settings later. +

+
+ +
+ +

Save the account: +

+
+ +
+ +

Confirm: +

+
+ +
+ +

Back to account settings page, still need to fix SMTP port + if DavMail is not listening on default port 25, + open account settings: +

+
+ +
+ +

Open Account Info: +

+
+ +
+

Open SMTP page: +

+
+ +
+

Choose primary server: +

+
+ +
+

Adjust SMTP port: +

+
+ +
+

Back to Account Info, open Advanced settings: +

+
+ +
+

Back to Account Info, open Advanced settings: +

+
+ +
+

Enable SSL on IMAP port: +

+
+ +
+

Mail setup is complete, proceed to + iPhone Carddav setup +

+
+
+
\ No newline at end of file diff --git a/src/site/xdoc/thunderbirdcarddavsetup.xml b/src/site/xdoc/thunderbirdcarddavsetup.xml index 301cf263..f1ee8d66 100644 --- a/src/site/xdoc/thunderbirdcarddavsetup.xml +++ b/src/site/xdoc/thunderbirdcarddavsetup.xml @@ -1,51 +1,50 @@ - - - - - DavMail POP/IMAP/SMTP/Caldav/Carddav/LDAP Exchange Gateway - Thunderbird Carddav setup - Mickael Guessant - - - - -
-

Thunderbird does not support Carddav natively, you will need to download and install the SOGo Connector - plugin from - SOGo Connector Thunderbird extension. -

-

Note: the SOGo connector is not yet available for thunderbird 3.

- - -

After plugin installation, restart Thunderbird, open address book and choose - File / New / Remote Address Book: -

-
- -
- -

Choose a name and enter contact folder location (adjust port to your settings):

- http://localhost:1080/users/mail@company.com/contacts - -

Replace mail@company.com with actual user email address. -

-
- -
- -

Press OK and launch synchronisation with the toolbar - Synchronize - button. -

- -

Provide your credentials, login is Active Directory account name, i.e. domain\account - or email address with Exchange 2007 -

-
- -
-
-
- + + + + + DavMail POP/IMAP/SMTP/Caldav/Carddav/LDAP Exchange Gateway - Thunderbird Carddav setup + Mickael Guessant + + + + +
+

Thunderbird does not support Carddav natively, you will need to download and install the SOGo Connector + plugin from + SOGo Connector Thunderbird extension. +

+ + +

After plugin installation, restart Thunderbird, open address book and choose + File / New / Remote Address Book: +

+
+ +
+ +

Choose a name and enter contact folder location (adjust port to your settings):

+ http://localhost:1080/users/mail@company.com/contacts + +

Replace mail@company.com with actual user email address. +

+
+ +
+ +

Press OK and launch synchronisation with the toolbar + Synchronize + button. +

+ +

Provide your credentials, login is Active Directory account name, i.e. domain\account + or email address with Exchange 2007 +

+
+ +
+
+
+
\ No newline at end of file