Unomi logo

Apache Unomi in one sentence

Apache Unomi is a Java Open Source customer data platform, a Java server designed to manage customers, leads and visitors’ data and help personalize customers’ experiences.

For developers

  • Uses ElasticSearch for data storage, dynamic data structure
  • Highly scalable architecture
  • Very simple to deploy and install (simply unzip & run)
  • Uses Apache Karaf as the OSGi runtime
  • Full & simple REST API
  • Extensible through plugin architecture (using OSGi & simple JSON descriptors)
  • Apache Open Source project

For IT stakeholders and business users

  • First-Party Data Collection and Ownership
  • Persistent and consolidated profiles for all your audience (customers & leads), storing anonymous and personally identifiable information
  • Regulation-proof and privacy management built-in
  • Real-Time Decisioning (Scoring logics, segmentation)
  • Open standard, easy integration and extension

Why would you need a Customer Data Platform ?

Organizations collect data from multiple sources and channels - sales, web, emails, mobile, brick and mortar - and all of this data is spread across different departments and technologies. As a result, many professionals are lacking the data they need to do their job, especially data analysts and marketers.

A customer data platform helps business users collect all the customer data in one place, providing a complete view of the customers. When the data is collected, the customer data platform will also play a key role in choosing which content or offer is more relevant to a customer.

The Apache Unomi advantage

Each organization is unique and will always have specific needs, this is why Apache Unomi has been designed to be extended and to ease the integration of external data. The embedded features such as segmentation, scoring and built-in privacy will be appreciated by business users while horizontal scalability and open source positioning will be loved by developers and architects.

Apache Unomi is also the reference implementation of the upcoming OASIS Context Server (CXS) standard ( to help standardize personalization of customer experience while promoting ethical web experience management and increased user privacy controls.

Business cases based on Unomi

  • Build a web personalization software to adapt the content on your website to your audience
  • Collect data from mobile application and feed Apache Unomi to track and understand your customers’ journeys
  • Connect the beacons deployed in your stores to Apache Unomi and consolidate the profile of your customers and leads across all these channels
  • Automatically push profiles from Apache Unomi to your CRM when a lead reach a given number of points in one of your scoring plans

Unomi logical architecture

All communication is done using HTTP REST requests and JSON data formats.

Unomi logical architecture

5 Minute Quick start

  1. Install JDK 8 (see and make sure you set the JAVA_HOME variable
  2. Download ElasticSearch here : (use version 5.1.2 for Unomi <= 1.2, 5.6.3 for Unomi >= 1.3)
  3. Uncompress it and change the config/elasticsearch.yml to include the following config : contextElasticSearch
  4. Launch ElasticSearch using : bin/elasticsearch
  5. Download Apache Unomi here :
  6. Start it using : ./bin/karaf
  7. Wait for startup to complete
  8. Try accessing https://localhost:9443/cxs/cluster with username/password: karaf/karaf . You might get a certificate warning in your browser, just accept it despite the warning it is safe.
  9. Request your first context by simply accessing : http://localhost:8181/context.js?sessionId=1234


  • 2017-09-28 Released version 1.2.0-incubating
  • 2017-07-19 New Salesforce CRM connector contributed
  • 2016-10-04 Released version 1.1.0-incubating
  • 2016-05-22 Released version 1.0.0-incubating
  • 2015-11-23 Initial code base import in Git repository
  • 2015-11-20 Added Apache Maturity Model report page
  • 2015-11-13 Initial web site created
  • 2015-10-20 JIRA, mailing lists, git, website space created.
  • 2015-10-05 Project enters incubation.

Articles & slides

Back to top

Reflow Maven skin by Andrius Velykis.