node package manager



A Seneca.js data storage plugin


npm version Build Status Coveralls Dependency Status Gitter


A storage engine that uses redis to persist data.

seneca-redis-store's source can be read in an annotated fashion by,

  • running npm run annotate
  • viewing online.

The annotated source can be found locally at ./doc/redis-store.html.

If you're using this module, and need help, you can:

If you are new to Seneca in general, please take a look at We have everything from tutorials to sample apps to help get you up and running quickly.

Seneca compatibility

Supports Seneca versions 1.x - 3.x


To install, simply use npm. Remember you will need to install Seneca.js if you haven't already.

npm install seneca
npm install seneca-redis-store

You also need redis running locally. Please visit redis for more info about how to install and run redis

Quick Example

String Uri

var opts = {
  'redis-store': 'redis://user:pass@host:port'

String Uri with Redis Options

var opts = {
  'redis-store': {
    uri: 'redis://user:pass@host:port',
    options: {...}
seneca.use('redis-store', opts);
seneca.ready(function() {
  var apple = seneca.make$('fruit') = 'Pink Lady'
  apple.price = 0.99$(function (err, apple) {
    console.log(" = " +

See the full list of available Redis options.


You don't use this module directly. It provides an underlying data storage engine for the Seneca entity API:

var entity = seneca.make$('typename')
entity.someproperty = "something"
entity.anotherproperty = 100$(function (err, entity) { ... })
entity.load$({id: ... }, function (err, entity) { ... })
entity.list$({property: ... }, function (err, entity) { ... })
entity.remove$({id: ... }, function (err, entity) { ... })


The Senecajs org encourage open participation. If you feel you can help in any way, be it with documentation, examples, extra testing, or new features please get in touch.


To run tests, simply use npm:

npm run test


Copyright (c) 2016, Marius Ursache and other contributors. Licensed under MIT.