How to install Zimbra 10.1 on Ubuntu 24.04 step-by-step

Here’s a step‑by‑step guide to install Zimbra Collaboration 10.1 on Ubuntu 24.04 (based on the latest available info and the official installer process). Note that, as of now, Ubuntu 24.04 support for Zimbra 10.1 is either in BETA or limited—you may need to use a 10.1 build that explicitly includes Ubuntu 24.04 support, or a community build with that support, before proceeding with production systems.

🧠 Before You Start — Requirements & Notes

  1. Ubuntu Server 24.04 LTS (a fresh install is recommended).
  2. Static IP address and proper DNS records for your mail domain (A, MX, etc.).
  3. FQDN hostname configured on the server.
  4. Root or sudo access on the server.
  5. A Zimbra 10.1 license key (for Network Edition; trial key available from Zimbra support). – Zimbra 10.1 introduced a new licensing system, and a license daemon service is required at install.
  6. Supported Zimbra 10.1 build for Ubuntu 24.04 — official download page lists a Beta build for Ubuntu 24.04 alongside supported builds for 22.04 and older OS versions.

⚠️ If the official distro does not yet fully support Ubuntu 24.04 for your release, consider using an officially supported OS version like Ubuntu 22.04 or waiting for the general support build.

📍 Step 1 — Initial System Setup

  1. Set timezonefor Bangladesh: 
    timedatectl set-timezone Asia/Dhaka
  2. Update the system: 
    sudo apt update && sudo apt upgrade -y
  3. Set the hostname (replace mail.atiqit.com with your mail server hostname): 
    sudo hostnamectl set-hostname mail.atiqit.com
  4. Edit /etc/hosts: 
    sudo nano /etc/hosts

    Add your server’s IP and hostname, e.g.:

    27.147.248.35 mail.atiqit.com mail
127.0.0.1 localhost
  5. Disable conflicting services:
    Zimbra needs to manage its own mail services. Stopping and disabling system mail can conflict — e.g.:

    sudo systemctl disable --now postfix
sudo systemctl disable --now sendmail

    (Ubuntu may not install these by default, but check if present)

📥 Step 2 — Download Zimbra 10.1

  1. Go to the official Zimbra downloads page and download the Zimbra Collaboration 10.1 installer for Ubuntu 24.04 (Beta) or for a supported Ubuntu build if available:
    https://www.zimbra.com/product/download/zimbra-collaboration-network-edition/
  2. Upload the .tgz file to your server, e.g., into /tmp: 
    cd /tmp
wget https://files.zimbra.com/downloads/10.1.0_BETA/zcs-NETWORK-10.1.0_BETA_4848.UBUNTU24_64.20260106140815.tgz
  3. Extract the installer: 
    tar xvzf zcs-NETWORK-10.1.0_BETA_4848.UBUNTU24_64.20260106140815.tgz

🛠 Step 3 — Run the Zimbra Installer

  1. Start the installer: 
    sudo ./install.sh
  2. The installer will begin with checks. If services like MySQL/MariaDB/Postfix are running, the installer will prompt you to disable them before continuing. Follow the prompts.
  3. Select packages to install.
    – For a single‑server setup, enable all core services (LDAP, MTA, Store, Proxy, etc.).
    – Leave optional ones off unless needed.
  4. License Activation:
    – Enter your Zimbra 10.1 license key when prompted (online or offline activation).
    – Without a valid key, the install can’t proceed.
  5. Confirm installation settings.
    – Accept default prompts unless you need custom paths or components.
  6. Post‑install configuration:
    – The installer will set up DB, LDAP, mail ports, and generate SSL certs if configured.

✔ Step 4 — Verify & Finalize

  1. Restart Zimbra services: 
    sudo su - zimbra -c "zmcontrol restart"
  2. Check status: 
    sudo su - zimbra -c "zmcontrol status"
  3. Access the Admin Console:
    – Use https://mail.atiqit.com:7071
    – Login with admin credentials you set during install.
  4. Configure DNS (MX, SPF, DKIM, DMARC) — essential for reliable mail delivery.

🧪 Notes & Troubleshooting

  1. If the installer complains about missing packages, install them manually using apt install.
  2. Disable AppArmor if it interferes (sudo systemctl disable --now apparmor).
  3. Make sure your domain’s DNS is correctly resolving externally before expecting mail delivery.

🚀 Post‑Install Checklist

✅ DNS A/MX records correct
✅ Reverse DNS (PTR) configured
✅ SSL certificates installed (Let’s Encrypt or purchased)
✅ User accounts provisioned
✅ Firewall rules allow ports: 25, 80, 443, 587, 993, etc.