Redis Configuration

This page is scheduled for review and update. Check back soon for updated content!

Nuxeo instances should be configured with a Redis server (in addition to the regular SQL database) in the following cases:

  1. When it's important that asynchronous jobs not yet executed be kept across server restarts.
  2. In cluster mode to allow:

Until Nuxeo 9.10 for a robust production instance, the first point is always necessary, which means that Redis should always be used. Visit the Nuxeo and Redis page for more information.

Since Nuxeo 9.10 Nuxeo Stream has been introduced and enables to use an alternative work manager that can rely on Kafka for the cluster mode, this cover point 1 and for some configuration point 2.

Since Nuxeo 10.10, the default transient store is KeyValueBlobTransientStore even if Redis is configured. To use the old RedisTransientStore you must set nuxeo.transientstore.provider=redis.

Configuring Redis

The Nuxeo Platform supports the following Redis versions:

Nuxeo Platform Version: LTS 2019 LTS 2017 LTS 2016
Redis 2.8.x

The following Redis configuration points should be checked:

  • The server memory should be enough to hold the Redis database (the size depends on the usage: transient store, cache, the backlog of asynchronous jobs).
  • Redis persistence should be configured appropriately for the level of service required. In particular the RDB files should be used as backups and periodically saved offsite.
  • Redis master-slave replication should be set up, for robustness (fast disaster recovery). Note that Nuxeo Platform 5.8 does not yet know how to use the slaves for read-only operation.

Configuring Nuxeo for Redis

To make the Nuxeo Platform use Redis, you must activate the redis template by adding it to the nuxeo.templates property of bin/nuxeo.conf, and specify the Redis hostname:


The must be the hostname or IP address of your master Redis server. All the Nuxeo instances in a Nuxeo cluster must of course point to the same Redis server.

Also available are (with defaults):


The nuxeo.redis.port is self-explanatory, 6379 is the value for a default Redis installation.

The nuxeo.redis.prefix is the prefix used for all Nuxeo keys stored and read in Redis. This allows you to use a single Redis server between several Nuxeo cluster installations by having a different prefix for each cluster, but this is not really recommended. All keys used for Work queue management have work: added after this prefix. Those related to caching use cache: after this prefix. For locking, lock: followed by the repository name is used.

The nuxeo.redis.password, nuxeo.redis.database and nuxeo.redis.timeout are standard Redis parameters, although rarely used.

nuxeo.redis.maxTotal sets the maximum size of the Redis connections pool (available since 8.2).

nuxeo.redis.maxIdle sets the maximum number of Redis idle connections in the pool (available since since 8.2).

When the redis template is used then the following is automatically activated as well: (As of Nuxeo Platform 5.8, work queuing is the only use of Redis in the standard Nuxeo modules, so it makes sense to activate both together.)


If you have chosen to configure TLS/SSL then you can set up Nuxeo using nuxeo.conf with the following properties:


See the Trust Store and Key Store Configuration page for more.


To activate the Redis cluster invalidation in cluster mode you need to add:


You can monitor that your cluster is able to send invalidations request using that command:

redis-cli psubscribe "*"

After editing a document, you should be able to see such message:

1) "pmessage"
2) "*"
3) "nuxeo:vcs:default"
4) "2:\xac\xed\x00\x05sr\x00,"​

High Availability

If needed, you may configure nuxeo for resolving the Redis server through sentinels.


Nuxeo will ask sentinel hosts in the declaring order at port 26379 for the server mymaster.

a month ago GitHub Fix release date on deprecated addons
3 years ago Solen Guitter 19 | se excerpt for compatibility version
3 years ago Manon Lumeau 18
4 years ago Solen Guitter 17
4 years ago Solen Guitter 16
4 years ago Antoine Taillefer 15
4 years ago Solen Guitter 14 | Update Redis version (3.0 instead of 2.8)
4 years ago Benoit Delbosc 13
4 years ago Benoit Delbosc 12
4 years ago Benoit Delbosc 11
4 years ago Antoine Taillefer 10
4 years ago Antoine Taillefer 9
4 years ago Maxime Hilaire 8
4 years ago Stéphane Lacoin 7
4 years ago Stéphane Lacoin 6
5 years ago Florent Guillaume 5 | Info about prefix.
6 years ago Solen Guitter 4 | use Nuxeo Platform 5.8 instead of Nuxeo 5.8
6 years ago Florent Guillaume 3
6 years ago Florent Guillaume 2
6 years ago Florent Guillaume 1
History: Created by Florent Guillaume

We'd love to hear your thoughts!

All fields required