1-888-77-Kerio

4 out of 5
*
*
*
*
*

Installing Kerio Connect

Article Number: 1124 | Rating: 4/5 from 1 votes | Last Updated: Fri, Apr 26, 2013 3:25 PM

Product editions

Standard installation package

Kerio Connect is available as a standard installation package for:

Windows
Mac OS X
Linux RPM
Linux Debian

VMware Virtual Appliance

Virtual appliance for VMware products.

VMware Virtual Appliance is a software appliance edition pre-installed on a virtual host for VMware. The virtual appliance is distributed as OVF and VMX.

See this article for detailed information.

Windows

For system requirements go to the product pages.

Download the Kerio Connect installation file.
Run the installation.

Kerio Connect must be installed under the user with administration rights to the system.
Kerio Connect is installed using the standard installation wizard. The initial configuration is performed (see section Configuration wizard).

The Kerio Connect installation process is logged in a special file located in folder %TEMP% (kerio-connect.setup.log).

Kerio Connect Engine is started (immediately or after restart). It runs as a service.

Mac OS X

For system requirements go to the product pages.

Download the Kerio Connect installation file.
Run the installation.

Kerio Connect must be installed under the user with administration rights to the system.
Kerio Connect is installed using the standard installation wizard into folder /usr/local/kerio/mailserver. The initial configuration is performed (see section Configuration wizard)
The Kerio Connect service starts automatically upon the computer system startup. To run or restart the service, run System Preferences → Other → Kerio Connect Monitor.

You can also stop, start or restart Kerio Connect through Terminal or a SSH client with the following commands with root access (for Mac OS X 10.5 Leopard or newer):

Stopping Kerio Connect Engine

sudo /usr/local/kerio/mailserver/KerioMailServer stop

Running Kerio Connect Engine

sudo /usr/local/kerio/mailserver/KerioMailServer start

Restarting Kerio Connect Engine

sudo /usr/local/kerio/mailserver/KerioMailServer restart

If possible, it is recommended to stop/start the service in System Preferences → Others → Kerio Connect Monitor

Do not delete the Kerio Connect installation package — it includes Kerio Connect Uninstaller.

Linux — RPM

For system requirements go to the product pages.

Download the Kerio Connect installation file.
Run the installation.

Kerio Connect must be installed under the user with root rights.

For installations, Kerio Connect uses the RPM application. All functions are available except the option of changing the Kerio Connect location.
Kerio Connect is installed into folder /opt/kerio/mailserver.
Run the configuration wizard (see section Configuration wizard).

New installation

Start the installation using this command:

# rpm -i <installation_file_name>

Example:

# rpm -i kerio-connect-8.0.0-6333.linux.rpm

In case of the recent versions of the distributions, problems with package dependencies might occur. If you cannot install Kerio Connect, download and install the compat-libstdc++ package.

It is recommended to read carefully the LINUX-README file immediately upon the installation. The file can be found in the installation directory in folder doc.

When the installation is completed successfully, run the configuration wizard to set the domain and the administrator's account:

cd /opt/kerio/mailserver 
./cfgwizard

The Kerio Connect Engine must be stopped while the configuration wizard is running.

Starting and stopping the server

Once all settings are finished successfully in the configuration wizard, Kerio Connect is ready to be started.

Within the installation, the kerio-connect script is created in the /etc/init.d directory which provides automatic startup of the daemon (i.e. Kerio Connect Engine) upon a reboot of the operating system. This script can also be used to start or stop the daemon manually, using the following commands:

/etc/init.d/kerio-connect start

/etc/init.d/kerio-connect stop

/etc/init.d/kerio-connect restart

Kerio Connect must be run under the user root.

If your distribution has systemd available, use the following command to start/stop Kerio Connect:

systemctl start kerio-connect.service

systemctl stop kerio-connect.service

Linux — DEB

For system requirements go to the product pages.

Download the Kerio Connect installation file.
Run the installation.

Kerio Connect must be installed under the user with root rights.
Kerio Connect is installed into folder /opt/kerio/mailserver.
Run the configuration wizard (see section Configuration wizard).

New installation

To install either of the installation packages, double-click on its icon or use for example the following command in the terminal:

# dpkg -i <installation_file_name.deb>

Example:

# dpkg -i kerio-connect-8.0.0-1270.linux.i386.deb

It is recommended to read carefully the DEBIAN-README file immediately upon the installation. The file can be found in the installation directory in folder doc.

When the installation is completed successfully, run the configuration wizard to set the domain and the administrator's account:

cd /opt/kerio/mailserver 
dpkg-reconfigure kerio-connect

Starting and stopping the server

Once all settings are finished successfully in the configuration wizard, Kerio Connect is ready to be started.

/etc/init.d/kerio-connect start

/etc/init.d/kerio-connect stop

/etc/init.d/kerio-connect restart

Kerio Connect must run under user root.

When installing on Debian with a graphical user interface, open the installation package with the gdebi installer (right-click the file and Open with).

Configuration Wizard

The configuration wizard helps to set the basic parameters for Kerio Connect. These include:

It also creates special files where the server configuration is saved.

If you do not use the configuration wizard, it will not be possible to login to the Kerio Connect's administration interface.

On Windows and Mac, the configuration file is run automatically during the installation.

On Linux, use the following commands:

Linux — RPM

cd /opt/kerio/mailserver

./cfgwizard

Linux — DEB

cd /opt/kerio/mailserver

dpkg-reconfigure kerio-connect

When a corresponding package is installed, user will be informed that the wizard is available. This information is also provided by the daemon if it detects that the wizard has not been used yet.

Kerio Connect must be stopped while settings are changed in the configuration wizard.

After running the wizard, existing configuration files will be deleted.

Configuration files

The wizard creates the following configuration files:

users.cfg

users.cfg is an XML file with the UTF-8 coding which includes information about user accounts, groups and aliases.

mailserver.cfg

mailserver.cfg is an XML file with the UTF-8 coding which contains any other parameters of Kerio Connect, such as configuration parameters of domains, back-ups, antispam filter, antivirus.

On Mac OS X and Linux systems, files can be maintained only if the user is logged in as the root user.