Page tree
Skip to end of metadata
Go to start of metadata

For the beginner the number of input parameters requested during install can be confusing but don't panic, you are usually fine with defaults and mandatory parameters, which will be highlighted when kept blank. All parameters can also be changed later via the Kopano4S-Admin GUI.

Special attention is on the mail-server section: when running in full server mode you have to provide a mail server name of your own domain with existing dns and mx record. Otherwise sending and receiving mails will likely fail. Equally most of you using dynamic IP address would set the mail relay of your provider. For fetchmail only in mailstore-foreword mode the mail-server name is less important (can be blank or localhost) but the mail relay is mandatory. For details on both modes running Kopano4S, Postfix vs. Fetchmail see info boxes below.

Step-by-Step Advise Install (see screenshots)

  1. Acknowledge the license condiditions for Kopano4S SPK and Kopano

  2. Basic Settings: provide MySql root password, db name, share location, select edition and attachment plus build mode

    root password to MySQl / MariaDB10 (not Unix) ensures database creation and will not be stored. For details on Kopano editions see FAQ. Mail Attachments by default are stored on file system, however if you are importing from legacy Zarafa you might need to de-select this as there arrachments had been indb.If you prefer to build Docker Image on your own select this as power-user option as you get the latest build.

  3. Ports and Services: ensure ports used are unique to other packages abd decide on optional services

    Each Port of Kopano services need to be exposed from Docker container; here you select the ports that must not conflict with other services on your Synology. Http prefix 9000 results in 9080 and 9443, ICAL 8000 results in 8080, 8443 and finally is the webapp port 8090 (https will be via reverse proxy). Then you can select Kopano services that are optional to be enabled.

  4. Mail-Server Settings: set your mail domain, mail server name, other options incl. TLS / SSL settings

    It is sufficient to provide 1 domain, but in case of more add them coma separated. To use TLS in Kopano you need to sync your Synology default certificate into the container (use subdomain like as alternate name). On webservices level you can activate webapp and z-push as reverse proxy virtual directory so you can use Kopano via port 443 instead of 9443. Rverse proxy is optional as it cannot be guranteed it working with any configuration though usually it works fine; as alternative you can configure Synology reverse proxy.

  5. Mail-Options (scanning etc.): add postmaster alias, mail relay and select scanning services

    It is important to map postmaster to existing Kopano account via alias to ensure receiving mails for default system anoucements. Set mail relay in case you have dynamic IP to avoid being tagged as spam. Select Spam scanning and rejection. Important note when enabling helo restrictions with mx sender domain validation this will also apply for your server, so if your sending mail server host is unknown (no dns, mx) you will reject yourself sending mails.

  6. Language Settings: set other language for any new created mailbox

    Select the language for your mailboxes. Note this only applies for new created ones.

  7. MySql Tuning etc.: prepare for MySql replication and do memory tuning

    Set a unique MySql Id (101) to be able setting up replication using kopano4s-replication. Select tuning option for Kopano allocating buffers to MySql and Kopano Server. With more than 1GB a good tuning option is 40%, while usually MySql does not utilize the full buffer, so it is 40% utilisation maximum, usually 30%.

Step-by-Step Advise Un-Install (see screenshots)

  1. Select what you want to keep for re-use (clean-up = de-select all)

    When planning to re-install you might keep the Kopano demon users on Synology level (keep UID) or keep the Kopano share to preserve backups. Only keep the database when re-installing the same version. For switching from Community to Supported Edition you have to drop the database and restore from backup (see FAQ)


Install Dialog Screenshots

Un-Install Dialog Screenshots

Kopano with Postfix SMTP Demon and own domain

In this setup you are hosting your own domain (e.g. on Synology. Postfix SmtpD has to be configured to send and receive emails via port 25 exposed to the Internet. Kopano sends emails to postfix and receives emails from postfix via LMTP Delivery Agent. In case you are using a dynamic IP address you need to setup a relay host to avoid your mails being rejected as SPAM for being an unknown host.


Kopano with Postfix and Fetchmail for IMAP / POP3 mailboxes

In this setup you either have an email address from a provider (e.g. or host your mailbox of your domain externally. Fetchmail receives your email via Imap/Pop3 and delivers it to Kopano via Dagent cmd-line tool. Kopano sends emails to postfix which are rooted via relay host to your providers SMTP server. There is no need to expose port 25 and Postfix needs less strict settings (recipient_restrictions).

Back to Kopano4S Home

Linked Articles