Gentoo - SysAdmin - Installation

From Kolab Wiki

Jump to: navigation, search

'Please read these words of caution before embarking on a possibly painful journey with Kolab2/Gentoo'

A german translation of these instructions can be found here.


Getting the news

Before installing the server you should always check the latest news so that you are up-to-date concerning the project status.

Installing the overlay

The tool layman is the preferred method for installing the Kolab2 overlay on your machine.

The following three commands are sufficient to retrieve the package definitions:

emerge layman
emerge subversion
#(for layman 1.1)
echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf
#(for layman 1.2)
echo "source /usr/local/portage/layman/make.conf" >> /etc/make.conf
#(for layman 1.3 and later)
echo "source /var/lib/layman/make.conf" >> /etc/make.conf
layman -f -a kolab
Installing Kolab2/Gentoo-2.2

At this point the instructions for the Kolab2/Gentoo-2.2 installation will start to deviate from the steps required for 2.1. The next version of the Kolab-Server on Gentoo is currently in preparation. As version 2.2 includes massive changes to core concepts it will still take a while until it is finished. The following link only leads to a preliminary version of the 2.2 installation instructions:

Specifying the package features

Several of the basic servers that are required for Kolab also need specific features. The following selects a reasonable set of use flags that should allow to run the Kolab server. If you would like to modify these flags you can do so, but check with the specific server pages if this conflicts with the Kolab requirements:

echo "
#### Kolab start
# Use flags
dev-lang/php kolab ldap nls session xml apache2 cgi force-cgi-redirect sqlite berkdb ftp imap ctype pcre

dev-libs/cyrus-sasl berkdb ldap ssl
dev-perl/perl-ldap sasl
net-nds/openldap berkdb crypt overlays perl readline ssl -sasl
net-ftp/proftpd ldap ssl

mail-mta/ssmtp mailwrapper
mail-mta/postfix ldap sasl ssl mailwrapper
net-libs/c-client kolab ssl
net-mail/cyrus-imapd kolab ssl
net-mail/cyrus-imap-admin kolab ssl
www-servers/apache ldap
dev-libs/apr-util ldap
#### Kolab end
" >> /etc/portage/package.use

Unmasking packages

There are some packages within portage that are still marked "unstable" but are required for the kolab server to work correctly. The following keyword settings must be added to your /etc/portage/package.keywords file to install the server.

echo "
#### Kolab start
# Keywords
net-mail/cyrus-imap-admin ~x86
net-mail/cyrus-imapd ~x86
net-libs/c-client ~x86
#### Kolab end
" >> /etc/portage/package.keywords

Installing Kolab2/Gentoo

A simple emerge should now install Kolab:

emerge kolabd

If you encouter errors during compilation, please check the corresponding troubleshooting section.


If you want to enable specific use flags provided by the kolabd ebuild, please consult the following pages:

USE-Flag "spam" 
Improved spam filtering
USE-Flag "horde" 
Horde webmail
USE-Flag "dav" 
DAV access to the web server
USE-Flag "mailman" 
Mailing list capabilities
USE-Flag "otrs" 
Ticket support system

Bootstrap kolab

Up to this point everything was standard portage stuff and the different Kolab components are not yet configured to work together as a groupware server. This is what bootstrapping will accomplish. At this point kolab will start modifying and controlling a number of your configuration files within /etc ! If you are uncertain whether you want that or need more details, please read the Configuration concept page.

/usr/share/kolabd/scripts/kolab_bootstrap -b

The script will ask you a few questions, configure Kolab and create a ssl certificate for you.

Start Kolab

Now you should be able to fire up Kolab and start adding users. Start the init script and go to the webpage the bootstrap script directs you to.

/etc/init.d/kolabd start

Either you stop here since everything works and you are a happy user of a Kolab server or you choose to continue with the troubleshooting section.

If you specifically have problems with sending/receiving mail, check the postfix troubleshooting part.

Kolab Extensions

The Kolab version on Gentoo features a few nice extensions. You could install Horde as a webmail client or add a ticket support system if you have many customers you need to support. Mailing lists are another supported feature.


It is possible to submit bugs to the Kolab bug tracker in case something is not working. Make sure these bugs have the keyword "gentoo" and are assigned to "wrobel".

In addition there is are some mailing lists and a forum available for discussions.

Personal tools