Apache Unomi CDP - Open-Source Customer Data Platform

This is a repackaged open source software product wherein additional charges apply for cloudimg support services.

## A Customer Data Platform, Ready on First Boot

Apache Unomi is the reference implementation of the OASIS Customer Data Platform (CDP) specification: a Java context server that collects, stores and serves visitor profiles, sessions, events, segments, scoring plans and personalization decisions over a clean REST/JSON API. This image delivers Unomi fully installed on Apache Karaf with a co-located search-engine datastore, a dedicated service account and systemd units, so you can create your first profile and run your first segment query within minutes of launch rather than assembling the stack by hand.

## Who This Is For

Marketing and growth engineering teams who need a self-hosted CDP inside their own VPC to unify visitor and customer data, without shipping first-party behavioural data to a third-party SaaS. Application and personalization developers who need a real, standards-compliant CDP endpoint to build profile, segment and event integrations against. Data and platform teams evaluating an open-source CDP for single-tenant profiling and proof-of-concept workloads.

## What Is Installed

• Apache Unomi, the official Apache binary distribution on Apache Karaf
• A single-node Elasticsearch 7.10.2 datastore for the context profile and event indices
• OpenJDK 11 as the Unomi/Karaf runtime; Elasticsearch runs on its own bundled JDK
• nginx fronting the Unomi REST surface on port 80 with an unauthenticated health endpoint
• A dedicated unprivileged unomi service account and systemd units that start the platform on boot

## Architecture Overview

The stack runs as three cooperating services on a single EC2 instance. Nginx receives inbound HTTP on port 80 and proxies requests to Unomi running inside Apache Karaf on the loopback interface. Unomi reads and writes profile, session and event data to a co-located Elasticsearch 7.10.2 node, also bound to loopback. All CDP index data and the Karaf data directory reside on a dedicated 40 GiB EBS volume mounted at /var/lib/unomi - separate from the OS disk, independently resizable, and preserved across instance launches.

## A Fully Open-Source, Redistributable Datastore

Unomi requires a search-engine datastore. This image ships Elasticsearch 7.10.2 in its OSS distribution, which is licensed entirely under Apache-2.0 - the last fully open-source Elasticsearch release, chosen deliberately so every byte of the appliance is open source. The datastore is bound to the loopback interface only.

## Secure By Default

• Unomi's REST API is protected by HTTP basic authentication. A one-shot first-boot service generates a unique administrator password on every instance, applies it, and writes it to a root-only file at /root/unomi-credentials.txt
• The context server, the Elasticsearch datastore and the Karaf shell are all bound to the loopback interface only
• The security group opens only SSH (port 22). Reach the REST API over an SSH tunnel, or open port 80 to your own network range behind your controls when you are ready
• The upstream thirdparty event API key is rotated to a per-instance value on first boot

## Getting Started

1. Launch the image on an m5.large instance or larger, with port 22 open to your management network

2. Connect over SSH as the default login user for your variant (the user guide lists it)

3. Retrieve the generated administrator password with sudo cat /root/unomi-credentials.txt

4. Confirm the cluster is answering with an authenticated call to /cxs/cluster

5. POST a context event or a profile and query it back to see the CDP round-trip

6. Open an SSH tunnel to reach the REST API from your workstation or application

7. Define your own segments, rules and scoring plans and start ingesting events

## Request a Guided Evaluation

Need help mapping your data model to Unomi profiles, segments and rules? Contact cloudimg to schedule a complimentary CDP architecture walkthrough. Our engineers will help you define your first segments, configure event ingestion, and validate the round-trip against your own data, so you can move from evaluation to production with confidence.

## 24/7 cloudimg Support

Every deployment is backed by cloudimg engineers available around the clock by email and live chat. Support covers deployment and sizing guidance, CDP data modelling (profiles, sessions, events, segments, rules and scoring), REST API integration, the Elasticsearch datastore, exposing the API securely behind TLS and authentication, backup and restore of the data volume, and Unomi and JVM tuning and troubleshooting. Critical issues receive a one-hour average response time.

Apache, Apache Unomi and Apache Karaf are trademarks of The Apache Software Foundation. Elasticsearch is a trademark of Elasticsearch B.V.