MailSuite Pro documentation

Mobile sync

Introduction

MailSuite Pro uses well-known, solid solution for storing contacts and calendars, DAV server SabreDAV. It's shipped as a solid part of MailSuite Pro, so you don't need to install it separately. And aside from providing storage backend, it also allows for syncing data with mobile devices or any application/platform which offers CalDAV/CardDAV support.

Mobile sync configuration

AdminPanel of MailSuite Pro contains configuration section for Mobile Sync.

In addition to "Enable mobile sync checkbox", the configuration screen contains three main parameters:

DAV server URL is the primary URL used for synchronization. Default value is automatically generated by adding /dav/server.php/ to MailSuite URL.

While this would work in most cases, it's recommended to configure a dedicated domain or subdomain for DAV use, check DAV server configuration page for details.

IMAP host name and SMTP host name are the hostnames for incoming and outgoing mail, respectively. By default, MailSuite Pro uses 127.0.0.1 (localhost) value for hostnames, but that wouldn't work for mobile device or a program running elsewhere. Thus, you'll need to put external hostname for your mail server there.

Using mobile sync

Now that you have this feature enabled, you can log into email account with MailSuite Pro to find all the sync settings within user account settings screen. Some devices/applications require DAV server URL while other need URL pointing to specific calendar or address book, and Mobile sync screen of account settings contains all these.

And in case of iOS-powered device like iPhone or iPad, you won't really need to deal with DAV URLs - just log into MailSuite Pro from your device, and you'll be offered to get iOS profile which will automatically configure your device for syncing mails, contacts and calendars.

Troubleshooting

In general case, mobile sync should work right away. However, in some cases, you might need to configure your web server to have mobile sync operational. Detailed guidelines for this are found here.

If it looks like the connection to DAV server is established, but your account credentials are not accepted, you can try logging into DAV server via your web browser. That feature is disabled by default, you can enable it by adding the following item to the array defined in data/settings/config.php file:

'labs.dav.use-browser-plugin' => true,

Upon adding the line, enter your DAV URL in address bar of web browser and enter credentials for any MailSuite Pro account. If they're rejected and prompt appears again, that means there's a configuration issue with your web server. Be sure to check this documentation page.

As of version 7.6, the product allows for switching between two authentication modes, Basic and Digest. By default, Basic auth method is used. In some cases, you might need to try switching to Digest mode, that's done by adding the following item to the array defined in data/settings/config.php file:

'labs.dav.use-digest-auth' => true,