2.5 Configuration Wizard
Prev | Chapter 2 Installation | Next

## 2.5 Configuration Wizard

The installation program for Windows and MacOS X operating systems automatically runs a wizard that helps to set the basic parameters for Kerio MailServer and 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 MailServer's administration interface.

The wizard can be also run on Linux. 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. To run the wizard use the following command:

    /opt/kerio/mailserver
    ./cfgwizard

### Warning

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

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

### Settings

Use the wizard to set the following:

- Create a domain — to enable creating user accounts (or groups) in Kerio MailServer, at least one local domain must be created. The first local domain created is the primary domain. Unlike in the other local domains, users can login by their usernames (In the other domains, it is necessary to use the full email address. For detailed information on domains, see chapter 7 Domain and its settings).

- Create an administration account which then will be used for login to the Kerio MailServer's administration interface — a crucial operation for your server's security is setting of the administration password. Blank password is not accepted. For security reasons passwords should consist at least of six characters.

- Setting of the DNS name of the Kerio MailServer host — the Internet hostname entry should show internet DNS name of the computer where Kerio MailServer is running (typically name of the computer with the primary domain name). Server names are used for server identification while establishing SMTP traffic.

  ### Warning

  If Kerio MailServer is running behind NAT, enter the Internet hostname that can be converted to the IP address of the sending server, i.e. the internet hostname of the firewall.

- Select a data store for the server — Kerio MailServer stores a relatively large amount of data (email messages, information about user folders, records, etc.). The administrator can select a different location to store data (e.g. another disk partition, RAID etc.). The store directory can be changed anytime later through the Kerio Administration Console (for more information, see chapter 12.6 Advanced Options). If the location is changed then it is necessary to move the files located in this directory to the new location. Prior to this potentially very time-consuming operation, the Kerio MailServer Engine must be stopped. It is therefore recommended to specify an appropriate data store directory within the installation process already.

### Configuration files

The wizard creates the following configuration files:

users.cfg

  The `users.cfg` file is an XML file that includes information about user account, groups and aliases.

  Administration name and password was written in this file by the configuration wizard.

mailserver.cfg

  `mailserver.cfg` is an XML file containing any other parameters of Kerio MailServer, such as configuration parameters of domains, back-ups, antispam filter, antivirus, etc.

  In this file, the local primary domain just created, Internet name of the server as well as the location of the message store was written.

  Information on these two files are saved in the XML format. They can be therefore modified by hand or re-generated by your applications. Backups or transfers of these files can be easily performed by simple copying.

  ### Warning

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

Prev | Up | Next
2.4 Installation | Contents | 2.6 Upgrade and Uninstallation