Install 3.1

Prepare Python

  • Make sure you enabled Python 2.7 since Kolab seems not to be ready for Python 3 yet:
$ eselect python list
eselect python list
Available Python interpreters:
  [1]   python2.7 
  [2]   python3.2
$ eselect python set 1


  • Unmask the “kolab” USE-flag for PHP and other related USE-flags for Roundcube:
# Double mask USE flags in order to unmask them
  • To unmask ebuilds for the latest version freeze, you might want to set the following keywords:
# Unmask Kolab components from latest version freeze.
<net-mail/kolab-9999 ~amd64
<dev-python/pykolab-9999 ~amd64
<net-nds/kolab-schema-9999 ~amd64
<www-apps/kolab-webadmin-9999 ~amd64
<www-apps/kolab-syncroton-9999 ~amd64
<www-apps/kolab-irony-9999 ~amd64
<dev-util/kolab-utils-9999 ~amd64
<www-apps/kolab-chwala-9999 ~amd64
<www-apps/kolab-freebusy-9999 ~amd64
<net-libs/libkolabxml-9999 ~amd64
<net-libs/libkolab-9999 ~amd64
<www-apps/kolab-roundcube-9999 ~amd64
<www-apps/kolab-roundcube-recipient-to-contact-9999 ~amd64
<www-apps/kolab-roundcube-contextmenu-9999 ~amd64
<www-apps/kolab-roundcube-listcommands-9999 ~amd64
www-apps/kolab-roundcube-threading-as-default ~amd64
www-apps/kolab-roundcube-identity-smtp ~amd64
# Use patched version for kolab.
dev-python/python-augeas ~amd64
# Versions used for recent kolab builds, stable
# unmasked version might work, too.
>=dev-php/smarty-3.1.12 ~amd64
>=dev-python/cheetah-2.4.4-r1 ~amd64
>=dev-python/python-ldap-2.4.13 ~amd64
>=dev-python/sqlalchemy-0.8.2 ~amd64
>=dev-python/icalendar-3.5 ~amd64

The net-mail/kolab ebuild is used to specify the version to be installed (e.g. 9999 for current head of the git repos). This will also define the required versions for the related packages. So you should only set the requested version to net-mail/kolab and unmask all available version for the others.

  • Kolab is using 389 directory service and also needs 'net-nds/389-admin' which is using Apache as webserver:
>=net-nds/389-ds-base- ~amd64
>=net-nds/389-admin-1.1.31 ~amd64
>=app-admin/389-ds-console-1.2.6 ~amd64
>=app-admin/389-admin-console-1.1.8 ~amd64
>=dev-libs/389-adminutil-1.1.15 ~amd64
>=www-apache/mod_nss-1.0.8-r1 ~amd64
>=dev-java/idm-console-framework-1.1.7 ~amd64
>=dev-perl/perl-mozldap-1.5.2 ~amd64


  • Enable the following USE flags for Kolab:
# kolab
net-mail/cyrus-imapd afs openldap sieve -mysql
dev-libs/cyrus-sasl openldap
dev-lang/php kolab
# kolab -> amavisd
net-analyzer/net-snmp perl
# kolab -> 389
app-crypt/mit-krb5 openldap
dev-libs/nss utils
www-servers/apache suexec threads
# kolab-chwala
dev-php/PEAR-Net_SMTP sasl
# pykolab
dev-lang/python sqlite
  • The Kolab object handling library libkolab is based on KDE libraries with enabled qt3support. If you don't use KDE, you need at least the following USE-flags to be enabled:
dev-qt/qtcore qt3support
dev-qt/qtdeclarative qt3support
dev-qt/qtgui dbus qt3support
dev-qt/qtopengl qt3support
dev-qt/qtsql qt3support
kde-base/kdelibs semantic-desktop
kde-base/kdepimlibs semantic-desktop
sys-libs/zlib minizip
dev-libs/libattica qt4
media-plugins/gst-plugins-meta ogg vorbis
sys-apps/dbus X
sys-auth/pambase consolekit
sys-auth/consolekit policykit
virtual/udev gudev hwdb
sys-fs/udev gudev hwdb
dev-libs/libxml2 python


  • Emerge Kolab:
$ emerge -avN kolab

Initial setup

  • Run setup-kolab to initially configure your new system:

setup-kolab assumes a fresh installation and might overwrite existing configuration files. You don't have to run this when updating Kolab.

$ setup-kolab