Nuxeo Add-Ons

Nuxeo Edge Cache

Updated: March 18, 2024

Nuxeo Edge Cache allows you to cache binaries from your Nuxeo server on an Edge Cache server closer to your clients. It can act like a Content Delivery Network, to improve the speed of your downloads.

Nuxeo Edge Cache is composed by one Nuxeo addon to be installed on the Nuxeo server, and agents to be installed on a computer that will serve as the Edge Cache server. These agents are available with installers for Windows and OS X, or as a Docker image.

Installation and Configuration

Nuxeo Addon Installation

First install the Nuxeo Edge Cache addon, available from the Nuxeo Marketplace.

This addon requires no specific installation steps. It can be installed like any other package with nuxeoctl command line or from the Update Center.

Nuxeo Edge Cache does not require any configuration on the Nuxeo server after its installation.

Agent Installation and Configuration

  1. Download and install the relevant agent for your system. They are available from the Marketplace Edge Cache page.
  2. Launch the Edge Cache agent and set it up.
    • Windows: follow the instructions displayed.
    • Linux: Use the command line (see the Command Line section below) to set up the Docker image.

Supported OS

  • Debian 8.0 Jessie
  • Ubuntu Xenial Xerus 16.04
  • Windows Server 2016

Command Line

The table below shows the available parameters.

Command Parameters Default Value Description
default GUI mode
console Console mode
--port The port to bind
--ssl Activates SSL encryption on listening socket
--ssl-key The SSL Key to use
--ssl-certificate The SSL Certificate to use
--ttl 30 The Time-To-Live for the Edge Cache server.
See the TTL section below
--folder /var/lib/nuxeo/edge/ The folder to use for cache storage
--size-limit 0 The size limit in Gb for this binding. 0 means unlimited.
--ips The IPs to redirect to this Edge Cache Server.
See the IPs section below.
--server-url The Nuxeo server to connect to
--username The Nuxeo administrator user
--password The Nuxeo administrator password
--edge-host The hostname or IP to this Edge Cache server
name The name of the connection
unbind Unbinds a Nuxeo server from the Edge Cache server
name The name of the Nuxeo server connection to unbind
list Lists all the defined bindings


When you connect to your Nuxeo server for download it will check the source IP that does the request. If the source IP belongs to a defined Nuxeo Edge Cache and this cache is alive, then it will redirect to it.

You can define the IP sources with the CIDR format:

  • will map all the network
  • will map just one IP
  •; will map those two networks

In the example, if three Edge Cache servers are defined on the same source, the closest definition will be evaluated first. If the source IP is then the second proxy will be used first if it is alive, then will fallback to the second, etc.

Time-To-Live (TTL)

The Time-To-Live is defined per Nuxeo server connection. It defines after how many seconds the Edge Cache server will be considered as offline.

The Edge Cache server will initiate a ping on the Nuxeo server every TTL - 2 seconds. For this reason the TTL cannot be inferior to 2 seconds.

Your Nuxeo server will redirect to your Edge Cache if the last ping from the Edge Cache server was received before the TTL expires. If not then it will send the binary itself and will not redirect to the Edge Cache for download, as it is considered dead.

How It Works

Improve Transfer Time

A great addition to cloud deployments or for customers with multiple remote sites, Nuxeo Edge Cache removes the need to download the same file again and again at a given site when several users want to access the same content.


Download Workflow

  1. The user requests a binary from the Nuxeo server.
  2. The Nuxeo server verifies if an Edge Cache server is registered on this IP.
  3. The Nuxeo server redirects to the Edge Cache server registered with this IP.
  4. The Edge Cache server receives the redirect request with the token.
  5. The Edge Cache server extracts the encryption key from the token.
  6. If the Edge Cache server has the binary stored and decrypted with the key, it is sent to the user. Else Edge Cache downloads the encrypted binary from the Nuxeo server and stores it while decrypting and sending it to the user.