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"
- 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 firstname.lastname@example.org (or join #citadel on freenode)