User Tools

Site Tools


OpenEMM Installation & Configuration Wiki

Latest Version of OpenEMM 21.04:
Latest Version of OpenEMM 21.10:
Utility Package for OpenEMM Deployment & Runtime: 21.04.086 (OpenEMM 21.04) or 21.10.041 (OpenEMM 21.10)
(as of November 19, 2021)

OpenEMM is a web based enterprise application for email and marketing automation. OpenEMM is used for automated email communication with customers, leads, members and employees.

This video briefly introduces OpenEMM:

You can download the source code of OpenEMM at GitHub:
If you do not want to compile and deploy the source code of OpenEMM manually, we recommend to download the package for OpenEMM deployment & runtime at . This package contains the OpenEMM Maintenance Tool (OMT) which lets you download, install and manage OpenEMM.
Alternatively, you may download the source code of OpenEMM from GitHub and compile and deploy the software manually yourself. See the instructions at the end of this page.

The guide to installation and administration of OpenEMM can be found here:

If you use MariaDB as database and plan to upgrade to OpenEMM 21.04 or 21.10, read section 7.4 of the Install&Admin Guide first!
We also offer an OVA version for OpenEMM 21.04:

We kindly ask you to contribute feedback for OpenEMM! Please leave your questions and comments in the OpenEMM forum at . This helps us to improve the documentation, installation, configuration and administration of OpenEMM.

More resources:

Here is a video with first steps:

If you want to install the context-sensitive online help feature of OpenEMM (including the user manual with about 500 pages), visit

to get the download link for the manual package. You can use this link in OMT’s menu “Install or update package from AGNITAS Cloud” to install the documentation.

1. Introduction

OpenEMM is a professional open source software for email marketing and automation. If you want to automate your email communication, OpenEMM is the right choice for you. The software is not artificially limited in any way, because we will not try to push you to use a commercial cloud OpenEMM service instead. You are free to operate OpenEMM on whatever hardware you like, depending on the performance you need.
The first version of OpenEMM was published in 2006. The source code of the frontend and the backend of OpenEMM 19.04 and later is available at GitHub. It uses the popular open source license AGLPv3. At the end of this page you can find instructions on how to build OpenEMM by yourself.

2. Requirements

  • RedHat 7 or 8; CentOS 7 or 8; SLES 15
  • Java Open JDK 8 or 11
  • Apache Tomcat 8.5 or 9
  • Python 3.8 or later
  • DBMS: MariaDB 10.2 or later; MySQL 5.7
  • MTA: Postfix 2.6 or later; Sendmail 8.10 or later
  • wkhtmltox or later
  • for HTTPS support: Apache Tomcat Native Library

3. Mailing Templates and Forms

You do not have to start from scratch when producing mailings and creating forms in OpenEMM. At you can download templates and forms which you can import into OpenEMM. Make sure to replace all placeholders for a company ID with value “1”.

4. Updates

The top of this Wiki lists the latest available versions of OpenEMM backend, frontend and the deployment & runtime package.

You can download the latest versions of packages with menu “Install or update package from AGNITAS Website” of OMT (OpenEMM Maintenance Tool). An update of the code will also update the schema of the OpenEMM database, if necessary.

If you do not use the latest version of OpenEMM, OMT offers you to upgrade to a new release. If you are not happy with the new release (or any other version of OpenEMM), you can roll back OpenEMM to an earlier (or later) version with menu “Switch OpenEMM version”.

Do not forget to restart OpenEMM with menu “Restart OpenEMM” after you have downloaded and installed an update package to activate it. But do the restart at an convenient time: Do not restart OpenEMM during a dispatch of a mailing, or right after the dispatch (due to the brief downtime of the redirect service causing missed openings and click redirects).

5. Administration

See the Installation & Administration Guides linked at the top of this document for extensive information on administration of OpenEMM.

6. Known Issues

6.1 Open Issues

  • O-409: openings and clicks are always shown for end user device class “PC” independent from its real origin

6.2 Fixed Issues or later:

  • E-7438: Added permission for REST API to GUI permissions or later:

  • E-8073: Since CentOS8 allows bigger process IDs than CentOS7, file names for admin and test mails can become too long (Sendmail)

7. New Features of OpenEMM 21.04 (major changes)

  • E-8150: allow selection of country-specific date formats
  • E-8105: WYSIWYG editor selects HTTPS protocol by default
  • E-8098: changed “password changed” warning mail from TXT to HTML format
  • E-8097: checkbox “Do not send mailings with empty text” in mailings of workflows deactivated by default
  • E-8038: improved usability of “activate” button in links tab
  • E-7933: improved usability for stopping and resuming mail dispatch
  • E-7895: link checker warns if HTTP protocol is used
  • E-7620: improved usability of button for web form testing
  • E-7554: validator to check for invalid agnTag syntax
  • E-7339: limit size of upload files
  • E-7138: show mailing ID and IP address of unsubscribe requests in detail view of recipients
  • E-7009: send login credentials automatically to newly created EMM users
  • E-6754: improved usability of mailing tab “Links”
  • E-6591: improved support of agn tags in WYSIWYG editor
  • E-6531: improved usability for not-equal condition in target group editor
  • E-6486: EQL now supports binding status “bounced”
  • E-6531: improved usability for not-equal condition in target group editor
  • E-6167: new method to ease saving of recipient data in action scripts
  • E-5501: show anonymous openings and clicks in monthly statistic of top 10 mailings
  • E-5491: re-organized (very long) list of permission settings
  • E-699: improved usability for tables of triggers
  • E-698: improved usability for tables of web forms
  • B-914: new methods setSubscriberBindingwithAction and sendServiceMail for RESTful API
  • O-490: DKIM support
  • S-2118: switch to optionally enforce setting of target groups for regular mailings

8. New Features of OpenEMM 21.10 (major changes)

  • E-8643: introduction of new quota system for usage of RESTful API
  • E-8525: improved usability for definition of default values in import profile
  • E-8420: list of datasource IDs sortable by description
  • E-8384: show warning if date-based mailings uses several target groups combined with OR instead of AND
  • E-8327: improve deletion of mailing lists (show helpful warnings, but permit deletion in more cases than before)
  • E-8319: new WS method to retrieve mailing info based on a range of send dates
  • E-8286: optional cleanup for recipients being inactive for 6, 12 or 24 months (data minimization/GDPR)
  • E-8270: new RESTful method to generate webview URL for mailing
  • E-8269: new RESTful method to list mailings received by a certain recipient
  • E-8238: CToken as replacement for CI in web form URLs to hinder form spamming
  • E-8211: Warning at leaving a mailing, when target group has been changed but mailing is not saved
  • E-8207: improve definition of customized gender values in import profile
  • E-8146: introduction of new quota system for webservices usage
  • E-7885: option to bulk unsubscribe recipient from selected or all mailing lists
  • E-7262: If another user is editing mailing, show his/her name in warning message
  • E-6613: allow to mark target groups as favourites and show them first in lists
  • E-5899: consider also duplicate email addresses when setting a recipient to status “bounced”
  • S-2187: optional cleanup after 7, 14 or 30 days of profile fields and tracking data for recipients who have unsubscribed from all lists (data minimization/GDPR)
  • S-2116: new RESTful method to dispatch mailing
  • L-0669: also show used mailing list in info popup that is shown before dispatch of a mailing

9. Roadmap for OpenEMM 22.04


10. Building OpenEMM yourself

Download the source code of OpenEMM from GitHub at to a directory of your choice.


$ sudo su -
# cd backend
# ./


Copy template files, and to files with names, and and adapt the paths listed in those three files to your needs.

$ cd frontend
$ ant -f build.xml
start.txt · Last modified: 2021/11/29 16:01 by ma