Node.js Redis

Using Redis with Node.js

In order to use Redis with Node.js you will need a Node.js Redis client. In following sections, we will demonstrate the use of node_redis, a complete Redis client for Node.js. Additional Node.js clients for Redis can be found under the Node.js section of the Redis Clients page.

Installing node_redis

node_redis installation instructions are given in the README file. To install using npm issue the following command:

npm issue the following command:

$ npm install redis 

Opening a Connection to Redis Using node_redis

The following code creates a connection to Redis using node_redis:

var redis = require('redis');
var client = redis.createClient(port, 'hostname', {no_ready_check: true});
client.auth('password', function (err) {
    if (err) throw err;
});

client.on('connect', function() {
    console.log('Connected to Redis');
});

To adapt this example to your code, make sure that you replace the following values with those of your database:

• In line 2, the first argument to createClient should be your database’s port
• In line 2, the second argument to createClient should be your database’s hostname or IP address
• In line 3, the first argument to auth should be your database’s password

Using SSL and node_redis

TLS/SSL is supported by node_redis as of version 2.4.0. The following example demonstrates how to:

var redis = require('redis');
var tls = require('tls');
var fs = require('fs');

var ssl = {
  key: fs.readFileSync('path_to_keyfile',encoding='ascii'),
  cert: fs.readFileSync('path_to_certfile',encoding='ascii'),
  ca: [ fs.readFileSync('path_to_ca_certfile',encoding='ascii') ]
};

var client = redis.createClient(port, 'hostname', {tls: ssl});
...

Reading and Writing Data with node_redis

Once connected to Redis, you can start reading and writing data. The following code snippet writes the value bar to the Redis key foo, reads it back, and prints it:

// open a connection to Redis
...

client.set("foo", "bar", redis.print);
client.get("foo", function (err, reply) {
    if (err) throw err;
    console.log(reply.toString());
});

The output of the above code should be:

$ node example_node_redis.js
Connected to Redis
bar

Redis Enterprise enables running Redis datasets in a highly available and auto-scalable manner, with predictable top performance.

The Redis Enterprise Software lets you install an enterprise grade Redis cluster in your environment of choice, whether an on-premises data-center or your preferred cloud platform. It gives you full control of your data and configuration – no clustering or sharding knowledge required!

Redis Enterprise Cloud is a fully-managed cloud service for hosting and running Redis dataset without dealing with nodes, clusters, failure recovery or performance stabilization. Our technology does all that in a fully automated manner. Redis Enterprise Cloud is available on all popular clouds and platforms-as-a-service.

For more information on using Redis Labs’ products and services with node-js please see the Howto page.