Skip to main content

Unomi 3

Introducing Apache Unomi 3

A major Customer Data Platform release — platform foundation (3.0) and product leap (3.1) as one story.

Apache Unomi 3 is a major open-source CDP release. It spans the 3.0 platform modernization and the 3.1 product capabilities operators need for multi-tenant production — told as one Unomi 3 story.

A strong second theme: Unomi 3 is also built for AI agents that need real customer memory (retrieve, store, summarize, segment) over a stable open API. See Unomi 3 for AI agents.

Unomi 3 steps up the search client (Elasticsearch 9), the runtime (Karaf 4.4; Java 17+ is the minimum, not a headline feature), and — across 3.1 — a platform-wide multi-tenancy refactor, OpenSearch, cluster-aware tasks, safer validation, and stronger tests.

The familiar REST map stays put: all 119 documented Unomi 2.x OpenAPI paths are still present in 3.1, with new endpoints added alongside. Optional V2 compatibility mode lets you phase authentication changes. Details in Migrating from Unomi 2.x.

The Unomi 3 journey

Unomi 3 journey diagram

By the numbers (since ~2.7)

  • Tests outpaced implementation: test Java LOC ~10k → 53k (~5.3×) while production Java grew ~60k → 101k (~1.7×)
  • Test/impl LOC ratio ~0.17 → 0.52
  • @Test annotations ~235 → 1,524
  • API stability: 119 / 119 OpenAPI paths retained in 3.1; +12 additive paths
  • Unit tests, not only ITs: new in-memory PersistenceService harness for fast, independent service tests

Stats from a pre-GA snapshot — regenerate at 3.1.0 GA before treating numbers as final. Do not cite stale JaCoCo %. Current downloadable stable: v3.1.0.

What’s in the box

  • Platform: ES9 client, Karaf 4.4, persistence clustering, health checks (requires Java 17+)
  • Product: multi-tenancy & API keys (major platform refactor), OpenSearch, task scheduler, condition validation, request tracing
  • Upgrade bridge: V2 compatibility mode for phased 2.x client migration
  • Docs: migration and platform-upgrade runbooks in the official manual

Try it

Download current stable Get started Manual

Community

Apache Unomi 3 is community-built software of the Apache Software Foundation. Among the many contributions, we especially want to thank Serge Huber (Inoyu) for an exceptional volume of engineering on this major release, alongside Jérôme Blanchard, Jonathan Sinovassin-Naik, and François G. (Jahia), and other community contributors.

← All posts