Install Zimbra on Ubuntu Server: Step-by-Step

Yes, you can install Zimbra Collaboration Suite (ZCS) on an Ubuntu Server, and this guide walks you through the entire process. The installation uses Zimbra’s own installer script, which handles most of the configuration, but you must first prepare the server with a static IP, a fully qualified domain name (FQDN), and the correct DNS records.

What Zimbra Is and How It Works

Zimbra is an open-source email and collaboration platform that provides email, contacts, calendars, tasks, and file sharing through a web interface. It runs on a Linux server and uses several components that the installer sets up for you:

• Postfix – the mail transfer agent (MTA) that sends and receives email via SMTP.
• Dovecot – the IMAP and POP3 server that lets clients access their mail.
• MariaDB/MySQL – the database storing accounts, folders, and metadata.
• OpenLDAP – the directory service that holds user and domain information.
• Jetty – the web server that serves the Zimbra webmail interface.
• SpamAssassin and ClamAV – for spam filtering and antivirus scanning.

The installer bundles all these into a single package, which is why installing Zimbra is mostly a matter of running one script and answering prompts.

Prerequisites Before You Start

Before downloading anything, make sure your server meets these requirements:

• Ubuntu Server 20.04 or 22.04 LTS – Zimbra officially supports these versions (check the release notes for the exact version you install).
• At least 8 GB RAM – more if you have many users; 4 GB is the bare minimum but will be slow.
• At least 30 GB free disk space – more if you expect heavy mail volume.
• A static IP address – DHCP is not suitable for a mail server.
• A fully qualified domain name (FQDN) – for example, mail.example.com.
• DNS records – an A record pointing mail.example.com to your server’s IP, and an MX record for your domain pointing to mail.example.com.
• Ports open – 25 (SMTP), 80 (HTTP), 110 (POP3), 143 (IMAP), 443 (HTTPS), 465 (SMTPS), 587 (submission), 993 (IMAPS), 995 (POP3S).

If you are testing in a lab, you can skip the MX record, but the server will not be able to receive mail from the internet without it.

Step-by-Step Installation

Once the prerequisites are in place, follow these steps on your Ubuntu server:

1. Update the system
   Run sudo apt update && sudo apt upgrade -y to bring all packages up to date.
2. Set the hostname
   Use sudo hostnamectl set-hostname mail.example.com and add the FQDN to /etc/hosts so it resolves to the static IP. For example:
   192.168.1.10 mail.example.com mail
3. Download Zimbra
   Go to the Zimbra downloads page, choose the Open Source Edition (or Network Edition if you have a license), and download the tar archive for Ubuntu. You can use wget with the direct link, or upload the file via SCP.
4. Extract the archive
   tar -xzf zcs-*.tar.gz and then cd into the extracted directory.
5. Run the installer
   Execute sudo ./install.sh. The script checks dependencies and asks if you want to proceed. If it reports missing packages, install them with sudo apt install and re-run.
6. Answer the prompts
   The installer asks for the Zimbra components to install. The defaults are fine for most setups. It then asks for the admin password – choose a strong one and remember it.
7. Configure the domain
   After the base install, the script offers a configuration menu. Select option 3 to set the admin password, and option 4 to add your mail domain (e.g., example.com). You can also adjust the hostname if needed.
8. Finish and verify
   Type a to apply the configuration, then q to quit. The installer starts Zimbra automatically. You can check status with sudo -u zimbra zmcontrol status.

After installation, access the admin console at https://mail.example.com:7071 and the webmail client at https://mail.example.com.

Common Problems and How to Fix Them

Several issues are common when installing Zimbra on Ubuntu:

• Hostname not resolving – If the installer complains about a missing FQDN, check /etc/hosts and ensure the hostname matches the A record.
• Port 25 blocked – Many ISPs block outbound port 25. If you cannot send mail, contact your provider or use a relay service.
• Missing dependencies – The installer may ask for packages like libpcre2-dev or netcat-openbsd. Install them and re-run.
• Installation hangs – This often happens when the system clock is wrong. Ensure the date and time are correct with ntpdate or timedatectl.
• Webmail shows “service unavailable” – Check that all services are running with zmcontrol status. If one is stopped, start it with zmcontrol start.

If you run into an error message you do not understand, search the Zimbra forums or the official documentation – most issues have been seen before and have a documented fix.

Zimbra Network Edition vs. Open Source Edition

Zimbra comes in two main editions:

• Open Source Edition (OSE) – Free to use, includes email, contacts, calendar, and basic admin. It lacks some advanced features like mobile sync (ActiveSync), Zimbra Drive, and support.
• Network Edition (NE) – Paid, with a per-user license. Adds features like Microsoft Outlook integration, mobile device sync, archiving, and professional support from Zimbra.

For a small business or a home lab, the Open Source Edition is usually sufficient. For a company with many users and a need for support, the Network Edition is worth the cost.

Cost and Hardware Considerations

The Open Source Edition costs nothing in licensing, but you still pay for the server hardware and electricity. A small setup can run on a VPS for as little as a few dollars per month, but you need to ensure the provider allows port 25. For a production environment, plan for:

• 1-2 CPU cores for every 50-100 users
• 2-4 GB RAM for every 100 users
• Disk space equal to 1-2 GB per user for mail storage

Backups are essential – use Zimbra’s built-in backup tools or a snapshot-based backup on your hypervisor.

Alternatives to Zimbra

If Zimbra does not fit your needs, consider these alternatives:

• Mail-in-a-Box – A simpler, all-in-one mail server that runs on Ubuntu and includes webmail, DNS, and spam filtering.
• iRedMail – A script that installs Postfix, Dovecot, and Roundcube on a clean Ubuntu server, with a lighter footprint than Zimbra.
• Modoboa – A web-based mail hosting platform that manages Postfix and Dovecot, with a modern interface.
• Microsoft 365 or Google Workspace – Hosted solutions that avoid server maintenance altogether, but with a monthly cost per user.

Each has trade-offs in ease of use, features, and cost. Zimbra is the best choice if you want a full collaboration suite with a webmail client that feels like a desktop application.

Frequently Asked Questions

How long does the installation take?

On a modern server with a decent internet connection, the download and installation take about 30-60 minutes. Most of the time is spent downloading the package and running the installer script.

Can I install Zimbra on Ubuntu with a different hostname?

Yes, you can use any FQDN, but it must be resolvable. If you later change the hostname, you need to update the Zimbra configuration and DNS records, which can be tricky.

Do I need a static IP for Zimbra?

Yes, a static IP is strongly recommended. A dynamic IP will cause mail delivery issues because other mail servers may reject connections from IPs without proper reverse DNS (PTR) records.

Can I install Zimbra alongside a web server like Apache?

It is possible, but not recommended. Zimbra uses ports 80 and 443 for its webmail, so you would need to configure a reverse proxy or change Zimbra’s ports. This adds complexity and can cause conflicts.

How do I upgrade Zimbra to a newer version?

Download the new version’s installer and run sudo ./install.sh again. The installer detects the existing installation and upgrades it, preserving your settings and mail data. Always back up before upgrading.

Is Zimbra secure by default?

Zimbra enables TLS for SMTP, IMAP, and HTTPS by default. However, you should also configure a firewall, keep the system updated, and set strong passwords. For extra security, consider using a VPN for admin access.

Related

• Wait for App to Start Before Cypress Tests
• Customize Mouse Cursor in Windows 11
• How to Hide Apps in Android Private Space