lucascbeyeler.zimbra

Zimbra

This is an unofficial Ansible role to install and set up Zimbra Collaboration Open Source Edition on Red Hat, CentOS, and Ubuntu Server.

Requirements

You need Ansible version 2.9.6 or higher.

Install

Zimbra is available on Ansible Galaxy, so to install this script on your machine, just run the following command:

ansible-galaxy install lucascbeyeler.zimbra

Update

When a new version of ansible-zimbra comes out, rerun the install command with the "-f" or "--force" option:

ansible-galaxy install -f lucascbeyeler.zimbra

Features

You can apply the configuration multiple times; installation will only happen if Zimbra is not already installed on the server.
Configure SpamAssassin, Pyzor, and Razor;
Set a logo for your server. WARNING: Read this article for more details about the logo;
Enable PolicyD service and web admin;
Set up Proxy Admin;
Redirect from HTTP to HTTPS;
Use LMTP Host Lookup in Native mode;
Customize your Zimbra Open Source Edition server.

Role Variables

hostname: Set the server's hostname WITHOUT the domain.
domain: Set the domain for the server and the main domain for your Zimbra server.
zmpasswd: Set a password for all services in your Zimbra server (admin account, LDAPServer) - WARNING: Avoid using special characters in the password during installation.
zmnetwork: Set the network for the Zimbra server.
zmlogologin: Provide the path to your logo for the Login Screen - do not provide a path and no image will be applied.
zmlogoapp: Provide the path to your logo for the Application Screen - do not provide a path and no image will be applied.
timezone: Specify the timezone to set on your server.
zimbra_version: Specify which version of Zimbra to install. Default is 8.8.15

Service Variables - Enter "y" or "n"

zimbra_ldap: Enable Zimbra LDAP Server - default: y
zimbra_logger: Enable Zimbra Logger Service - default: y
zimbra_mta: Enable Zimbra MTA Service - default: y
zimbra_dnscache: Enable Zimbra DNS Cache Service - default: n
zimbra_snmp: Enable Zimbra SNMP Checks - default: n
zimbra_store: Enable Zimbra Store Service - default: y
zimbra_apache: Enable Zimbra Web Interface (Apache Web Server) - default: y
zimbra_spell: Enable Zimbra Spell Check - default: y
zimbra_memcached: Enable Zimbra Cache Service (Memcached) - default: y
zimbra_proxy: Enable Zimbra Proxy Service - default: y
zimbra_chat: Enable Zimbra Chat - default: n
zimbra_drive: Enable Zimbra ownCloud Drive - default: n
zimbra_imapd: Enable Zimbra IMAPD Solo Service BETA - default: n
zimbra_policyd: Enable Zimbra PolicyD Service - default: n

Dependencies

To use this playbook, you also need to run lucascbeyeler.baseline. This playbook does not include server preparation tasks, like system upgrades or hostname changes (these are common tasks). This separation helps to avoid repeating the same code in every project.

Example Playbook

    - hosts: zimbra
      become: yes
      become_method: sudo
      roles:
         - role: lucascbeyeler.zimbra
           hostname: localhost
           domain: localdomain
           timezone: America/Sao_Paulo
           zmpasswd: 123change
           zmnetwork: 192.168.122.0/24
           zmlogologin: /tmp/login.png
           zmlogoapp: /tmp/app.png