Getting Started

Quick Overview

Updated: March 18, 2024

What is Nuxeo Platform

Nuxeo Platform is a set of server and client side software artifacts and tools that allow you to build, operate and maintain advanced content management applications: core business applications with strong DAM or Case Management flavors, verticalised document management systems, hyperscale archival repositories and more. Among all the reasons why you would like to use Nuxeo Platform for your project, the most obvious are:

  • A proven track of reached performances goals
  • A state of the art technical design and software engineering tooling
  • Advanced content repository, workflow and content transformation features
  • An open development model with great documentation and great visibility on product evolutions that enables you to quickly reach a high level of expertise

Main components of the Nuxeo Platform are:

  • The Nuxeo Server, that runs on top of the Java Virtual Machine, with different deployment options. The Nuxeo Server exposes a modular set of features via a REST API. The Nuxeo Package system allows to easily define what bundles are deployed on the Nuxeo Server. Nuxeo Server is often called Nuxeo Platform as a shortcut, and because it is clearly the most important asset of the Nuxeo Platform, embedding a fully featured repository, a content transformation grid and a workflow engine. The Nuxeo Server is benchmarked continuously to guarantee performance expectations

  • Nuxeo Web UI: a flexible and pluggable content browser that allows users to perform usual content management operations in a highly productive style: browse, search, upload, preview, download, resolve tasks etc... WEB UI's strength is its capability of be heavily customised for taking into account your application's data model and custom business process.

  • Nuxeo Addons: as we said above, you can install additional bundles on top of the bare Nuxeo server to enrich its features and capabilities set. Nuxeo Addons compatible with a given version of the Nuxeo Server are distributed through the Nuxeo Marketplace.

  • Client SDKs and Nuxeo Elements: Java, JavaScript, C#, Python, PHP, iOS, DART : several clients are available for quickly start integrating with Nuxeo Server without having to know the details of our REST API. We even provide a rich set of web components, the "Nuxeo Elements" that brings out-of-the-box features that you can include in your application just by using the good HTML tag.

  • Nuxeo Drive: a desktop application that maps a Nuxeo repository's content to a Desktop's file system, with synchronization logics and offline access and edit capabilities, in the spirit of Enterprise File Sharing Systems like Dropbox or Box.

  • Nuxeo Mobile: Native Android and iOS applications developed with React Native and available on respective stores.

  • Build, QA and Performance analysis tooling All the tooling we use for building, maintaining and testing our software artifacts is free and open source. It is available for your own project, as a great catalyzer of your engineering practices.

  • Nuxeo Studio and Nuxeo CLI: Nuxeo Studio is an online application with which you can easily implement project's customisation requirements: content modeling, business logic and user interface design. Nuxeo Studio is much more than a rapid application development tool: it guarantees you that your customisation will be maintained automatically throughout the future releases of Nuxeo Platform components. Nuxeo CLI is a command line tool for helping developers bootstrap their custom modules.

  • Additional Client Integrations: Some additional client integrations are available: Adobe CC plugin, Salesforce application, AutoCad Plugin, Slack integration and more.

  • PaaS and Docker Deployment Tooling Nuxeo has strong expertise in deploying Nuxeo Platform instances on docker containers, PaaS style, which you typically want to do if you are building a verticalised application on top of Nuxeo and have multi-tenancy considerations

Turnkey Application and Headless Repository

You may be interested in using Nuxeo Platform for you project for different use cases:

  • If you need a headless scalable document repository with rich apis and data structures
  • If you need a turnkey application for managing assets (description, validation, publishing) with still ability to strongly customize it
  • If you want to build a custom UI upon the repository and want to benefit from our rich library of UI elements to accelerate the development of your project.

Technical Overview

Languages and configuration / customization principles

All server parts of Nuxeo, including plugins, are written in Java, with a mechanism of bundles and components for packaging developments. The Web UI (the customizable client web application) is written in JavaScript (using the Polymer framework). Default application can be configured using Nuxeo Studio, an online development environment. It is also possible to write Java plugins.

Deployment

Nuxeo Server comes bundled with a Tomcat server. It requires for production to set up several other components: Elasticsearch, Redis, a relational (SQL) database or NoSQL store (like MongoDB). Deployment options support HA, failover and can be on-premise, or in the cloud, on bare machines, virtual machines or Docker containers. For more details about the Nuxeo deployment system, please refer to pages on Standard High Availability Nuxeo Cluster Architecture. Nuxeo bundles can even be started on a JVM directly (i.e without an application sever). This is the deployment mode in all unit tests.

About Nuxeo Platform Data

Data managed by the Nuxeo Platform includes:

  • Documents:
    • Metadata
    • Binary files
  • Users, Groups
  • Reference data
  • Indexes

Document Repository

The Nuxeo Document repository focuses on managing Document persistence.

It covers:

  • Hierarchy definition
  • Security descriptors
  • Metadata
  • Binaries
  • Indexes

The default configuration for Nuxeo Repository is to use a SQL Database and a Filesystem storage, as well as an Elasticsearch index (that can be removed from the architecture if necessary):

  • To manage hierarchy, security and metadata the Nuxeo repository provides a generic Java interface with two implementations: VCS that integrates with SQL databases, or DBS that integrates with NoSQL databases. You can easily configure the backend of your choice, among MongoDB, PostgreSQL, Oracle, MySQL, MariaDB, Microsoft SQL Server and MarkLogic. Implementing a new relational or document backend, if needed, is straightforward.
  • Binaries streams are stored in a "Object Store like" storage called "BlobProvider". Many implementations are provided out of the box (File System, S3, Azure Blob Storage, JCloud, Google Drive, Dropbox and more) and it is straightforward to add a new implementation.

For more details about Nuxeo Repository and BlobStore, please see the page File Storage.

The following schema shows main persisted and indexed data on a typical Nuxeo setup.

Indexes

The standard setup of Nuxeo Platform includes using an Elasticsearch index used in most of the queries made in the application. Yet the repository can be deployed and used without those additional Elasticsearch indexes. VCS implementation even natively includes full-text search.

Non Document Data

Nuxeo uses an abstraction called Directory system that allows to address Data in SQL, LDAP (or WebService). The Directories are typically used for storing:

  • Users
  • Groups
  • Lists of controlled values

By default, everything is bound to the same SQL database as the repository, but you can choose:

  • To bind some directories to LDAP
  • To bind some directories to an external SQL database

Integrating Nuxeo

Calling Nuxeo Services

Nuxeo resources (Documents, Users, Tasks ...) are exposed via a REST API. Nuxeo services are exposed via an HTTP API called Nuxeo Automation.

So, if your external application needs to call the Nuxeo Server you can use plain HTTP/JSon API to do the calls, or you can use one of the client libraries we provide.

Calling External Services from the Nuxeo Sever

You can extend the Nuxeo Platform to deploy your own Java Services. A standard approach is to wrap your calls to external applications inside a Nuxeo Automation Operation (or, event better, inside a Nuxeo Service wrapped in an an Automation operation). Once you have this operation, you can use it Nuxeo Studio for deep integration in your business pocesses:

  • Use it inside a Workflow.
  • Bind the call to the external service on new buttons in the UI.
  • Associate your external service operation with events happening inside the repository.

Data Integration

In addition of the native HTTP API, the Nuxeo Platform also provides solutions to import data inside the Nuxeo Platform.

Customizing the Web UI

The Web UI is written on top of the Web Components standard and the paradigms of the Polymer Framework.