How To Install Zimbra Collaboration Suite (ZCS) On Ubuntu

Version 1.0
Author: Falko Timme
Last edited 03/05/2007

This guide shows how to install the Zimbra Collaboration Suite (ZCS) on Ubuntu 6.10 (Edgy Eft) and 6.06 (Dapper Drake) server systems. Zimbra is a full-featured, open source collaboration suite - email, group calendaring, contacts, and web document management and authoring. It has a feature-rich AJAX web interface and is compatible with clients such as Microsoft Outlook, Apple Mail, and Novell Evolution so that mail, contacts, and calendar items can be synchronised from these to the ZCS server. It can also be synchronized to many mobile devices. ZCS makes use of many existing open source projects such as Postfix, MySQL, and OpenLDAP.

I do not issue any guarantee that this will work for you!


1 Preliminary Note

Please download the Ubuntu 6.10 or 6.06 server CD from and install a basic Ubuntu system with it. Don't install/enable any services (e.g. like LAMP or DNS) - if you do, you'll have to disable them later on as they might interfere with Zimbra!

After the installation of the base system, we'll do some additional configuration, e.g. enable the root account, install an SSH daemon, apply a static IP address and a hostname to the system.

I will use the hostname in this tutorial together with the IP address Adjust this to your needs, but make sure that has a valid MX record in DNS (Zimbra needs this!). I assume you want to create email accounts for instead of, so you should have an MX record for as well.

In this example the Zimbra server is in a local network ( is a private IP address) behind a router, so make sure you use the router's public IP address ( in this example) in the DNS records - of course this IP address should be static. If you have a dynamic IP address, you could use a service such as, but keep in mind that most public IP addresses are blacklisted nowadays.

So if you use BIND on the authoritative name server for, you should have something like this in's zone file:

[...]        A        MX 0             MX 0

If your Ubuntu server is behind router, make sure that you forward at least port 25 from your router to your Ubuntu server.

If your Ubuntu server is in a data center, it most likely has a static public IP address and a hostname, so you can skip chapter 1.3, but still you must make sure that this hostname has a valid MX record.


1.1 Enable The root Account

To enable the root account, run

sudo passwd root

and specify a password for root.

Afterwards, become root by running


All following commands in this tutorial are executed as root (unless something else is written)!


1.2 Install The SSH Daemon

Just run

apt-get install ssh openssh-server

to install the SSH daemon.


1.3 Apply A Static IP Address And Hostname

Edit /etc/network/interfaces and adjust it to your needs (in this example setup I will use the IP address

vi /etc/network/interfaces

# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static

Then restart your network:

/etc/init.d/networking restart

Then edit /etc/hosts. Make it look like this:

vi /etc/hosts       localhost.localdomain    localhost      mail

# The following lines are desirable for IPv6 capable hosts
::1     ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
ff02::3 ip6-allhosts

Now run

echo > /etc/hostname

and reboot the system:

shutdown -r now

Afterwards, run

hostname -f

Both should show

From now on you can use an SSH client such as PuTTY and connect from your workstation to your Ubuntu server and follow the remaining steps from this tutorial.


1.4 Disable The Ubuntu CD In /etc/apt/sources.list

I like to install all packages over the internet instead of from the Ubuntu CD, therefore I disable the Ubuntu CD in /etc/apt/sources.list now:

vi /etc/apt/sources.list

On Ubuntu 6.10 ("Edgy Eft"), comment out this line:

#deb cdrom:[Ubuntu-Server 6.10 _Edgy Eft_ - Release i386 (20061025.1)]/ edgy main restricted

On Ubuntu 6.06 ("Dapper Drake"), it's this line:

#deb cdrom:[Ubuntu-Server 6.06 _Dapper Drake_ - Release i386 (20060531)]/ dapper main restricted

Then update the packages database by running

apt-get update


1.5 Disable Services

If this is no fresh system and you have some services already running (such as Postfix, Apache, OpenLDAP), you must disable them first before installing Zimbra. Otherwise Zimbra will fail to install.

For example, to disable Postfix on your system, run

/etc/init.d/postfix stop
update-rc.d -f postfix remove

The commands for the other services are similar.

Share this page:

7 Comment(s)

Add comment


From: at: 2007-03-08 11:18:44

please consider if you have the time to publish the same tutorial for Centos (or any redhat clone) it will be more valuable knowing that most servers use RHEL or RHEL clones.

Thank you for your time


From: at: 2008-03-26 09:55:39

Do you really need the point 1.1 Enable The root Account?
I personaly dont like to enable the root account as it is a main target on a server...
May you just use "sudo bash" to execute commands as root, should do fine ;-)

From: Anonymous at: 2009-01-21 00:23:27

Please help,

when installing I get:

zimbra-proxy ....   ....done

Can´t locate Tie/ ib @INC (@INC contains: .......) at /opt/zimbra/zimbramon/lib/Net/ line 10

BEGIN failed - compilation aborted at opt/zimbra/zimbramon/lib/Net/ line 10

compilation failed in require at /opt/zimbra/libexec/ line 22

BEGIN failed - compilation aborted at /opt/zimbra/libexec/ line 22

From: Anonymous at: 2009-07-03 03:41:46

found this during the install from a note on installing scalix.

From: at: 2007-07-30 07:19:51

Just a quick note: not all the features listed are features of the Open Source version.  Consult the product comparison map on the Zimbra website to see which capabilities each verson has.

 Having said that, it seems to be worth it, especially the calendaring is very powerful.  Thanks for the HOWTO, it saves a lot of time!


From: at: 2008-04-05 03:56:21

Many many thanks to writer of this greate how to, it is really helpfull and it just works

I am new to this forum so let me be part of this please

I followed this how to and got my zimbra running without any major issue. I cannot figure out where this info should go  /etc/hosts  or /etc/resolv.conf or somewhere else

[...]        A        MX 0             MX 0

so followed rest and it still worked very nice but I was not able to browse by domain and that is why I could got any email or reply I was successfull in sending mails, but I used IP instead and that worked. I am really thankfull to writer and asking for little help to clear where this stuff stated above suppose to go and if possible give me exact files contents which will be greate help. Thank you in advance

From: Oniemusha at: 2010-07-15 08:25:56

This is a nice site who really are linux noobz. i just followed the instruction and voila my zimbra mail is online. Again, thank you for a nice work!!!!