Installation Checklist

Kiwi has very few dependencies so other than it's own binaries and plug-ins you can typically have a full installation (Mail Server, Web Server, Web Mail, Web Administration, et al) up and running in only a few minutes.

Microsoft Windows System Requirements

Windows XP onwards (Server versions preferred - but will work on desktop editions)
Single or Multi-Processor CPU
Storage: Full install (single domain - all services) ~6Mb

Linux & BSD System Requirements

Linux kernel 2.5.44 onwards
FreeBSD 4.1 onwards
Storage: Full install (single domain - all services) ~6Mb

Optional Components (in no order of preference)

Microsoft Certificate Services
OpenSSL package (also useful for certificate management)
Postgres Database server
MySQL Database server

Getting Started

After you have chosen your desired Kiwi installation (See Downloads) and proceeded your way through the relevant Installer (no more difficult than clicking Next until you reach the Finish button) you are left with the following folder layout on your system:

[your_chosen_install_location]
- Kiwi
  - bin
  - certificates
  - conf
  - domains
    - .global
    - localhost.localdomain
      - accounts
        
        postmaster
        
        messages
        
        policy
        
        website
        
        docs
        
        errors
        
        scripts
        
        icons
      - conf
      - policy
      - website
        
        docs
        
        errors
        
        scripts
        
        icons
  - logs
  - msgq
  - plugins
    - smtp
    - imap4
    - pop3
    - ims
    - mta
    - shared
    - http
  - policy
  - temp

All that is left is for you to decide is which Kiwi services you want to use, and how they should be configured on your system. To aid this process each Installer will place on your Start menu shortcuts to some useful scripts that Install and Remove the Kiwi services from the Microsoft Windows Services list.

Kiwi Scripts

Install Kiwi (Full) - inst-all-svcs.cmd
Remove Kiwi (Full) - rem-all-svcs.cmd
Install Kiwi/Mail Server - inst-mail-svc.cmd
Remove Kiwi/Mail Server - rem-mail-svc.cmd
Install Kiwi/Web Server - inst-web-svc.cmd
Remove Kiwi/Web Server - rem-web-svc.cmd

These scripts should be used if you are unfamiliar with configuring services from the Command line and only need to be started once after the Kiwi Installer has completed, either from the Start menu or from the Microsoft Command line.

Installing & Removing Kiwi packages

It is important to note that each script assumes that your System has not had another Kiwi package installed on it. For example you should not Install the kiwi/Mail server package and then subsequently install the Kiwi/Web Server package on top of this as each of these services depend on a shared service, namely the 'Local Services Manager'. You can run multiple Kiwi installations side-by-side but you must install each package using a different set of service Identifiers - The Installation & Removal scripts do not include such functionality.

Once the Installation scripts have completed they will automatically start the relevant Kiwi services and your system should now be ready for creating your first Domain.

Domains

With each new Kiwi installation your first task once the system is up and running is going to be setting up your Domains. The problem that immediately arises is that your unable to use the Web Administration panel either because you've only installed the kiwi/Mail server or that the kiwi/Web server is running without any domains and therefore cannot access any local webspace to run the Web Administration application! Ouch!

To alleviate this 'Chicken and Egg' problem it was decided that during the install phase that the domain 'localhost.localdomain' will automatically be added to your Kiwi system configuration. Once you've then added your own Domains you can then if necessary remove this domain.

If you are happy to customise the Install scripts you can of course add your domain as part of the Installation script thus alleviating the need to create this dummy domain and any potential security risks associated with it.

Proceed to Domain Management

k.i.w.i.

Installation Checklist

Getting Started

Domains