How to Install Zimbra Collaboration Suite in Ubuntu Server

How to Install Zimbra Collaboration Suite in Ubuntu Server

Zimbra Collaboration Suite (ZCS) is a next generation collaboration and communication platform, with a mission to answer the challenges posed on large organisations by legacy mailing systems. While Zimbra also offers hosted solutions, the Open Source edition is a self hosted mailing platform, retaining most of the functionality of the paid version.

Zimbra is…

  • Cross platform: (Linux, Mac, Windows). Running from a server, it can be accessed as an AJAX web application from most major browsers
  • Innovative: The interface features functionality usually found in desktop applications such as drag and drop or advanced search functionality
  • Secure: You get full control over your accounts and data
  • Easy to maintain: You get full CLI or web-based control over your installation
  • Compatible: Besides the web-client, you can access our Zimbra messages from Outlook and other desktop mail clients as well.

Installing Zimbra is surprisingly straight forward and could be completed under 10 minutes. Zimbra recommends that you disable SELinux and any firewall running, before installation. The OpenSouce Edition was installed on a fresh, full-stack Ubuntu 14.04.2 LTS Server; the instance for this was for tutorial’s sake, with all standard components left intact.

Preparing your system

After logging or sshing in to your Ubuntu 14.04 Server installation, you need to become root. Instead of using su, it is a good idea to proceed with

Besides the advantages of sudo over su, sudo -s will not change your $HOME variable, thus you will keep working in your user’s home directory.

Zimbra will conflict with postfix. You could just disable it, but it is probably best to uninstall it entirely if you plan to use Zimbra for messaging anyway.

Ubuntu links sh to dash, but the Zimbra installer will complain if it does not find bash where it expects it. To fix this, you should point sh to bash:

Configuring the network

You will need a static IP address, if you do not already have one. Editing the /etc/network/interfaces file would be the easiest option.

Change the file to include the following lines. Of course, the addresses should be replaced according to your own network configuration.

Zimbra network interaces

On the test installation, the hostname used was “”, which is not a registered domain name. Yours should be a real one, if you plan to use Zimbra.

After running

and specifying your own domain, edit the file /etc/hosts

And change it to include the following (using your own IP and domain name, of course):

Save it and restart the network services, to make sure all the changes take effect.

Now your server is almost prepared. To install prerequisite packages, it is best to let the Zimbra installer script check what’s missing.

Obtaining Zimbra

You can get the installation files in any way you like from the Zimbra download page. At the time of writing, the freshest available OpenSource version was 8.6.0 GA. To get it from the terminal, just copy and paste

and wait for the download to finish. Once it is downloaded, you’ll need to unpack the file. Using the asterik (*) wildcard below will unpack whatever version of Zimbra you have just downloaded, (if it is the only such downloaded file in your current directory), so you are safe to copy and paste the below command:

Installing missing dependencies

The Zimbra install script has automatic dependency checking. You can run it just to see what you might be missing. Enter the unpacked directory, and run the installer:

It will ask you to accept the License Agreement

Zimbra License Agreement

You will then have to select all the packages, like you were to install them, and the installer will tell you what is missing:

Zimbra prerequisit check

Quit the installer and install all the missing packages

Installing Zimbra OS Edition

You should run the installer again:

After having you accept the license once again, it will not complain now, but start building Zimbra.

You will still have a few questions to answer. First you will need to select (again) the components you want to install. The default answer is “yes;” pressing Enter will accept the component. To skip any of the components, press “n.”

Select Zimbra components

After accepting the “System will be modified” dialogue, the installation continues, up to the point of the DNS check. At this point it might complain about MX (mail exchange) record. It is best to set up an MX domain here. Fortunately the installer has the option to do this in-line:

MX record error

The installer should soon take you to main the configuration menu:

Zimbra main config menu

An obvious next step is to set up the missing admin password. Pressing “7” will take you to the zimbra-store sub-menu:

Enter the submenu

If you press “4”, you will find it has generated a random password for you. Press Enter to accept it (and don’t forget to make a note of it), or type your own here.

Auto generated password

Note: This is a weak point of the otherwise solid installer script. The password will be written plain on the screen and there is no confirmation dialogue either. Be careful, you only have one shot. It is best to double-check your password before pressing Enter.

Press “r” to return to the main menu

Zimbra main menu closed

You can choose which components should be enabled or disabled and set them up one by one, entering their number. Once ready, press “a” to finish up the installation.

Congratulations, if you’ve managed to get this far, you have just installed Zimbra OS edition on your server.

Checking if everything works

To make sure everything is up and running, check the status of each component with the zimbracontrol command. Zimbra has created a new user called “zimbra”, to which you should switch next, using su

Then start the status monitor:

You should have a similar result:

Final check

To access your web admin interface and configure your installation, go to

(using the IP you have specified of course), and enter your credentials.

zMailCloud Admin Console


Zimbra is an excellent collaboration and communication tool that is surprisingly easy to install on Ubuntu Server. You can have Zimbra up and running in under ten minutes. For further information on how to set up and use your new installation, you can find detailed documentation in PDF format in your downloaded Zimbra package or by visiting the Zimbra support website.

Attila Orosz Attila Orosz

Attila is a writer, blogger and author with a background in IT management. Using GNU/Linux systems both personally and professionally, his advice stems from 10+ years of hands on experience. In his free time he also runs the popular Meditation for Beginners blog.


    1. Thanks for spotting that. Auto-correct picked both words up… I hope my mis-spelling does not interfere with the installation process. :)

  1. Hello

    After installing (which according to your post) when in the admin I get the following error when clicking on some options:

    Message: system failure: exception during auth {RemoteManager:>} Error code: service.FAILURE Details:soap:Receiver

    (for example, when I click on Configure -> Servers -> then double click on my server I get this error, I also get this error when I click on Certificates)

    I have followed every guide online such as regenerating the keys etc but nothing seems to work….

    Any ideas?

    Thanks :)

    1. Hi,

      That sounds a lot like an SSH port problem. First you should check if your server has ssh server at all:

      ssh localhost

      If nothing happens, it probably means that you do not. Install it with

      sudo apt-get install openssh-server

      (If it does not start automatically, try

      sudo service ssh start

      although this should usually not be necessary), and see if this resolves the problem.

      If it still does not work, you might need to change the port in use. First configure your server:

      sudo nano /etc/ssh/sshd_config

      And look for the part (somewhere around the top of the file) where it says

      # What ports, IPs and protocols we listen for
      Port 22

      and change the port number to anything you like and is not in use yet. (Although according to IANA you should avoid reserved ports. Private ports range from 49152 to 65535).

      Let’s say your new port is 55555. Change the above line to

      # What ports, IPs and protocols we listen for
      Port 55555

      then restart the service with

      sudo service ssh restart

      Now configure your Zimbra server:

      su zimbra
      zmprov mcf zimbraRemoteManagementPort 55555

      (Note: This is preferred to the method zmprov ms zimbraRemoteManagementPort 55555 seen advised on many forums, as you need to change the port globally)

      and restart Zimbra:

      zmcontrol restart

      Exit the zimbra user:


      And you should be done. Let me know if this solves your problem.

  2. Hello, have followed all the steps and have managed to install zimbra up to the end but when i reach the point of accessing my web interface, i get a message in my browser saying that the page in not available. What could be the cause ???

    1. Hm. Did you get any particular error messages during installation? Is Zimbra server surely running? You could check it with:

      su zimbra

      followed by

      zmcontrol status

      If you see no error here, just make sure you use the right IP address (that of your server) and port 7071 to connect. (the IP given in the post will not work, unless it’s the same on your side)

      I.e. go to the address in your browser, where x.x.x.x is your server’s IP address:


      (It i also important to note,, that this is a https address.

  3. My second question, how do I change the default port numbers to some thing else just for security purposes.

    1. Hey,

      I don’t have it installed, I’ve only ever done that for the article’s sake (to be able to take screenshots), my servers run different setups. :) So I cannot really check for you.

      I suggest you visit the Zimbra Wiki:

      It has many how-to and guide articles, that might help. There are also some good community resources. hope that helps.

    2. My original answer is now awaiting moderation for containing a link. until then you can find my previous answer for changing remote access port, if that is what you were looking for (look at the previous question,l there is a detailed how to in my answer). :)

  4. Great Articles it helps me a lot… I followed all the steps in your post… Our New Zimbra Mail System has been successfully deployed in Virtualized Server, up and running smoothly… thanks Attila Orosz.

  5. Hello Attila Orosz, Our New Created Mail System with Zimbra 8 Collaboration Suite has been successfully deployed on Virtualized Server and hosted with the Domain Name: I’m very happy, lucky and thankful for your great articles you posted here because I was followed all your instruction on how to provision such mail system with an open source messaging and collaboration platform… the best article I have read and followed compare to other articles related to you post… again thank you very much for sharing this post GOD BLESS and more power….ocsITspecialist…

Comments are closed.