Citadel Ebuild

The Gentoo Ebuilds are now in the Sunrise overlay. So you just need to use layman to install sunrise on your system and then you can emerge them as usual. The WebCit ebuild is unnfortunately hardmasked, since the overlay maintainers consider the included TinyMCE, Protaculous/Scriptaculous as “third party libraries”. Don't get scared away! They are third party addditions, but like most content management system or other webinterface, a WYSIWYG editor and some javascripting toolsets are part of the package.

If you are unfamiliar with local overlays, read up here: http://en.gentoo-wiki.com/wiki/Overlay

emerge layman
layman -a sunrise

Now you have the ebuilds in place on your system. We need to befriend the system with the packages:

The file /etc/portage/package.keywords holds a list of packages which are allowed to be installed in “unstable” versions. Since our packages are not in the official portage tree, they are treated as “testing”. They are masked by a keyword, depending on your systems architecture. If you never used keywords or are unsure what your architecture is, just copy and paste the examples below, they work on most 32bit and 64bit Gentoo PC installations.

echo "dev-libs/libcitadel ~x86 ~amd64" >> /etc/portage/package.keywords
echo "mail-mta/citadel ~x86 ~amd64" >> /etc/portage/package.keywords
echo "www-servers/webcit ~x86 ~amd64" >> /etc/portage/package.keywords
echo "www-servers/webcit" >> /etc/portage/package.unmask

The folowing command will ask you if you are ok with the choice it makes. Just hit enter or type in “y(es)” and on we go.

emerge citadel -va

If you want to install WebCit aswell use

emerge citadel webcit -va

• Follow the instructions in the messages after succesful installation! There is a comfy way to get citadel up and running nearly instantly. There is also the typical installation method via /usr/lib/citadel/setup for advanced users or if you want different auth mechanisms (PAM, LDAP, MS Active Directory)

First time users should use the

emerge --config mail-mta/citadel-$VERSION"

approach!!!

• It simply asks for the IP address on which webcit should listen, an admin account name and the according password. (It will use “BlackBox” authetification mode and use the standard port 504)

• WebCit will be configured via /etc/conf.d/webcit (I ditched the setup tool!)

• Everything should work normally now, for question ask themgt@mail.ru (or join #citadel on freenode)

Upstream bugs administrating adoption:

• WebCit: http://bugs.gentoo.org/show_bug.cgi?id=123139
• CitServer: http://bugs.gentoo.org/show_bug.cgi?id=62119
• LibCitadel: http://bugs.gentoo.org/show_bug.cgi?id=286323