Zarafa

From the Linux and Unix Users Group at Virginia Teck Wiki
Jump to: navigation, search

Zarafa is a software libre groupware server. The for-pay enterprise version provides Microsoft Exchange server functionality. The gratis and libre community version of Zarafa supports, POP3, IMAP, CalDAV and a web application interface out-of-the-box, allowing Mac, Mozilla and Novell PIM applications (i.e. Mac Mail, Thunderbird, Lightning and Evolution) to easily connect to its information stores. Additionally, Zarafa is a useful back-end for Z-Push and these packages setup together enable full-fledged, locally served Android synchronization. With additional configuration and integration, using LDAP for contact storage and access in Zarafa is also possible.

Setup Guide

The following instructions were written for CentOS 5 and may not work on other platforms or versions. If you would like to see additional coverage, please add it yourself or make a request on the wiki's wanted page.

Prerequisites

Zarafa requires a MySQL database server be accessible. If you don't already have one, setup and run MySQL on your local machine.

Installation

Download the non-Outlook, software libre, binary package from the community section of the company's website. If you want to give it a proper extension, it's a gzipped tarball so you can name it zarafa.tar.gz if you like. Unpack the tarball and run the installation script. If you have RPM errors, check to see if you have older versions of the dependencies it ships with already installed. If this is the case, removing them should lead to successful execution of the installation script.

# wget 'http://url.com' -O zarafa.tar.gz
# tar -xf zarafa.tar.gz
# zarafa-*/install.sh

Give the installation script the login information to your MySQL database when asked.

Configuration

Zarafa has a flexible, pluggable user system. If you have a fully functional LDAP or Active Directory server, go ahead and use it. The default MySQL database backend works fine out-of-the-box, but a Unix backend is also available. If you don't know what to choose, just don't change anything to use the database backend.

If you want to use the Unix backend, edit /etc/zarafa/unix.cfg and change the domain to your own.

# Default email domain for constructing new users
# Required, no default
default_domain = domain.com

Lastly, you'll need to add a user. How you do this depends on the user backend you chose. If you went with the default database backend, an administration tool is provided. Read the man page or run zarafa-admin --help for the full documentation. A quick example is below.

# zarafa-admin -c username -e username@domain.com -f 'Full Username' -P

Starting services

The first time you run the installation script, it may start some services for you. Below is the list of services if you would like to start additional services or stop them.

zarafa-server 
Main server
zarafa-spooler 
Outgoing mail service
zarafa-monitor 
Quota monitoring service
zarafa-gateway 
POP and IMAP service
zarafa-ical 
iCal/CalDAV service

Accessing the PIM

Calendar

The calendar can be accessed through CalDAV from the url http://domain.com:8080/caldav/username. Public calendars can be accessed from http://domain.com:8080/caldav/public/calendar.

External Links