Introduction

This document is intended as a base to quickly install Kopano Server and WebApp. You will need a server with a supported distribution, i.e. Debian 7 and 8, Ubuntu 14.04 and 16.04, RHEL 6 and 7, CentOS 6 and 7 and SLES 12, and install Kopano Server packages, Kopano WebApp, Apache webserver and MySQL server.

(warning) To install Kopano on Univention, installation can be done via the marketplace.

Installation

Add repositories

Our repositories are available at https://download.kopano.io/supported/ for customers and partners with a valid subscription. The serial is needed to access these repositories.



Create a file called kopano.list in /etc/apt/sources.list.d/  and add the following.

Take note that the following is an example for Debian 8. Adjust them according to your specific distribution if needed, such as Ubuntu_16.04

#Core
deb https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/core:/final/Debian_8.0/ ./ 

#WebApp
deb https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/webapp:/final/Debian_8.0/ ./

#WebApp Files
deb https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/files:/final/Debian_8.0/ ./

#WebApp Mobile Device Management
deb https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/mdm:/final/Debian_8.0/ ./

#WebApp S/MIME
deb https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/smime:/final/Debian_8.0/ ./

#Webmeetings:
deb https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/webmeetings:/final/Debian_8.0/ ./

Our packages are signed so we need to add the key as well.

$ curl https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/core:/final/Debian_8.0/Release.key | apt-key add -


All our packages are signed by the same key so you only need to add the key once


Create a file called kopano.repo in /etc/yum.repos.d/kopano.repo and add the following.

Take note that the following is an example for RHEL 7 and CentOS 7. Adjust them according to your specific distribution if needed.

[Kopano-core] 
name=Final repository for Kopano-core (RHEL_7) 
type=rpm-md 
baseurl=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/core:/final/RHEL_7/
gpgcheck=0
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/core:/final/RHEL_7/repodata/repomd.xml.key
enabled=1 
 
[Kopano-files] 
name=Final repository for Kopano-files (RHEL_7) 
type=rpm-md 
baseurl=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/files:/final/RHEL_7/
gpgcheck=0
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/files:/final/RHEL_7/repodata/repomd.xml.key
enabled=1 
 
[Kopano-mdm] 
name=Final repository for Kopano-mdm (RHEL_7) 
type=rpm-md 
baseurl=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/mdm:/final/RHEL_7/
gpgcheck=0
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/mdm:/final/RHEL_7/repodata/repomd.xml.key
enabled=1 
 
[Kopano-smime] 
name=Final repository for Kopano-smime (RHEL_7) 
type=rpm-md 
baseurl=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/smime:/final/RHEL_7/
gpgcheck=0
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/smime:/final/RHEL_7/repodata/repomd.xml.key
enabled=1 
 
[Kopano-webapp] 
name=Final repository for Kopano-webapp (RHEL_7) 
type=rpm-md 
baseurl=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/webapp:/final/RHEL_7/
gpgcheck=0
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/webapp:/final/RHEL_7/repodata/repomd.xml.key
enabled=1 
 
[Kopano-webmeetings] 
name=Final repository for Kopano-webmeetings (RHEL_7) 
type=rpm-md 
baseurl=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/webmeetings:/final/RHEL_7/
gpgcheck=0
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/webmeetings:/final/RHEL_7/repodata/repomd.xml.key
enabled=1 



Create a file called kopano.repo in /etc/zypp/repos.d/kopano.repo and add the following.

Take note that the following is an example for SLE 12. Adjust them according to your specific distribution if needed.

[Kopano-core] 
enabled=1
autorefresh=0
baseurl=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/core:/final/SLE_12/
gpgcheck=0
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/core:/final/SLE_12/repodata/repomd.xml.key
type=rpm-md 
 
[Kopano-files] 
enabled=1
autorefresh=0
baseurl=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/files:/final/SLE_12/
gpgcheck=0
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/files:/final/SLE_12/repodata/repomd.xml.key
type=rpm-md 
 
[Kopano-mdm] 
enabled=1
autorefresh=0
baseurl=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/mdm:/final/SLE_12/
gpgcheck=0
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/mdm:/final/SLE_12/repodata/repomd.xml.key
type=rpm-md 
 
[Kopano-smime] 
enabled=1
autorefresh=0
baseurl=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/smime:/final/SLE_12/
gpgcheck=0
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/smime:/final/SLE_12/repodata/repomd.xml.key
type=rpm-md 
 
[Kopano-webapp] 
enabled=1
autorefresh=0
baseurl=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/webapp:/final/SLE_12/
gpgcheck=0
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/webapp:/final/SLE_12/repodata/repomd.xml.key
type=rpm-md 
 
[Kopano-webmeetings] 
enabled=1
autorefresh=0
baseurl=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/webmeetings:/final/SLE_12/
gpgcheck=0
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/webmeetings:/final/SLE_12/repodata/repomd.xml.key
type=rpm-md 
 



 

Install Kopano Server packages and MySQL

We will now install kopano-server-packages and the MySQL server.

kopano-server-packages is a meta package that has a dependency to the basic kopano-core packages

The following is installed with kopano-server-packages

Install Kopano and MySQL/MariaDB


First install apt-transport-https 

sudo apt install apt-transport-https 

 

Update the apt database so the Kopano repositories are added

$ sudo apt update

and install

$ sudo apt install mysql-server kopano-server-packages




$ sudo yum install kopano-server-packages mariadb-server mariadb




$ zypper install mariadb-server kopano-server-packages






Now create a user in the MySQL server

$ sudo mysql -u root -p   
mysql> CREATE USER 'kopano'@'localhost' IDENTIFIED BY '<KOPANO-MYSQL-PASSWORD>'; 
mysql> GRANT ALL PRIVILEGES ON kopano.* TO 'kopano'@'localhost';


Change the MySQL password in the /etc/kopano/server.cfg

# The user under which we connect with MySQL 
mysql_user = kopano 
# The password for the user (leave empty for no password)
mysql_password = <KOPANO-MYSQL-PASSWORD>

Now start  the kopano-server

$ sudo systemctl start kopano-server

 

Create a user

There are several user plugins in Kopano, in this example we will use the database plugin so we can create users directly in the Kopano database;

$ sudo kopano-admin -c user1 -f "John Doe" -e user1@kopano.demo -p "PASSWORD"


To see if the kopano-server is started and contains users, use kopano-admin -l 

User list for Default(2):
        Username        Fullname        Homeserver
        ------------------------------------------
        SYSTEM          SYSTEM          Kopano
        user1           John Doe

Install WebApp and Apache webserver

 

We will now install the main client of Kopano; WebApp

We already added the repository before so we only need to install it.

We will use Apache as webserver and only install kopano-webapp. To see all available plugins use the command 'apt-cache search kopano-webapp' 

$ sudo apt install apache2 libapache2-mod-php5 kopano-webapp
$ sudo systemctl reload apache2

Login

You can now login in WebApp

Install and configure MTA

The next step would be to configure a MTA such as Postfix. Please click here for the Postfix configuration