Skip to content

SOGo App

About

SOGo is a fully supported and trusted groupware server with a focus on scalability and open standards.

Login

SOGo only works with mailbox accounts on the Cloudron. Login using the full email address including the domain as the username.

Identities

SOGo is setup out of the box as an email client for Cloudron for all mailboxes on the Cloudron.

The full name is set from the Cloudron user profile. To change the name, you must change the name in Cloudron dashboard and restart SOGo. Without restarting SOGo, the name change does not get picked up by SOGo since it appears to cache the value in memory.

To add an identity, go to Preferences -> Mail -> IMAP Accounts -> New identity:

By default, user's cannot change their full name inside SOGo. To allow users to change their name, change SOGoMailCustomFromEnabled to YES in /app/data/sogo.conf using the File manager and restart the app. Please note that this variable already exists in the config file and creating duplicate entries will cause SOGo to not start up.

External domains

The SOGo app does not support adding domains that are not managed in Cloudron. Consider using the rainloop app as an alternative.

Sieve Scripts

SOGo UI only supports setting up a limited set of filtering rules. You can setup more advanced rules using the SnappyMail or Roundcube app.

CalDAV

SOGo supports syncing using CalDAV:

Clicking on the 'ribbon' next to the calendar shows a popup menu.

Clicking on Links to this Calendar will show the calendar settings for various clients.

Calendar URLs

CalDAV URL - https://sogo.example.com/SOGo/dav//Calendar/personal/
Wedav ICS URL - https://sogo.example.com/SOGo/dav//Calendar/personal.ics
WebDAV XML URL - https://sogo.example.com/SOGo/dav//Calendar/personal.xml

CardDAV

Clicking on the 'ribbon' next to the address book shows a popup menu.

Clicking on Links to this Address book will show the address book settings for various clients.

Address book URLs

CardDAV URL - https://sogo.example.com/SOGo/dav//Contacts/personal/

ActiveSync

Exchange ActiveSync is a protocol used by Microsoft Exchange to sync mobile devices. ActiveSync clients can fully synchronize contacts, emails, events and tasks with SOGo. Freebusy and GAL lookups are also supported, as well as "Smart reply" and "Smart forward" operations.

Cloudron SOGo package supports ActiveSync out of the box. It can be added in Window Mail using Add an account -> Advanced Setup and choosing Exchange ActiveSync. When adding the account:

  • Use the mailbox as the email address. For example, girish@cloudron.example.
  • Use the mailbox owner's password as the password.
  • Use the mailbox as the username. For example, girish@cloudron.example.
  • Use the mail domain as the Domain. For example, cloudron.example.
  • Use the SOGo app domain as the Server. For example, sogo.cloudron.example.
  • Make sure SSL is checked
  • Use the mailbox as the Account name. For example, girish@cloudron.example.

See the forum thread for some screenshots.

Autodiscover

The account form can be filled up automatically if autodiscover.xml is set up.

Disabling ActiveSync

To disable ActiveSync , set WOWorkersCount to 0 in /app/data/sogo.conf using the File manager and restart the app.

Tuning ActiveSync

EAS support can be performance heavy. See SOGo configuration guide section 8 for fine tuning options. The suggestion configurion in that document for 100 users and 10 EAS devices is:

WOWorkersCount = 15;
SOGoMaximumPingInterval = 3540;
SOGoMaximumSyncInterval = 3540;
SOGoInternalSyncInterval = 30;

Make the necessary adjustments in /app/data/sogo.conf using the File manager and restart the app.

UI Issues

SOGo behaves differently depending on how you access the app. If you navigate to SOGo by clicking on the icon on your Cloudron dashboard, parts of the SOGo UI do not work.

This issue manifests itself as:

  • Email delete button not working
  • Compose email popup not closing. Sometimes, it ends up closing the tab itself.
  • The browser's web inspector console displays a DOMException with the message "Permission denied to access property \"$mailboxController\" on cross-origin object".

To workaround this, always use SOGo by opening a new browser tab and entering the SOGo domain name directly.

CalDAV and CardDAV Migration

Follow this guide to migrate CardDAV and CalDAV resources to and from existing installations.

Mark as spam

To mark emails as spam (or ham), click on the gravatar icon in the email header. Then, there is a thumbs down icon for marking as spam.

Cloudron user directory

The Cloudron user directory can be used in SOGo as a shared read-only address book.

To enable or disable this behavior, set isAddressBook to YES or NO in the SOGoUserSources section in the end of /app/data/sogo.conf:

...
    SOGoUserSources = ({
        type = ldap;
        ...
        isAddressBook = YES;
        displayName = Cloudron;
    });
...

The displayName can also be modified and is used in the UI to represent this addressbook.

After saving the file, the app needs to be restarted.