Install multiple redis instances via Puppet to configure a cluster with redis-trib.rb (for Redis version >= 3.0)
Switch branches/tags
Nothing to show
Clone or download


Table of Contents

  1. Overview
  2. Github repository
  3. Requirements
  4. Beginning with redis_cluster
  5. Development


The redis_cluster module lets you use Puppet to install and configure multiple instances of Redis in the same node.

Redis_cluster module Features:

  • Redis cluster configuration (Redis >= 3.0)
  • Redis configuration (with Augeas)
  • Multiple Redis Instances in the same node (with systemd)

Github repository


Note: to install the latest version of Redis (>= 3.0 is required for the clustering support), the module adds the repository to /etc/apt/sources.list.d/

Beginning with redis_cluster

To use the redis_cluster module with two instances:

# The global redis preferences (required by redis_cluster::instance class)
class {'redis_cluster':
  redis_version   => 'present',

# The first redis instance
  ip   => '',
  port => '7000',

# The second redis instance
  ip   => '',
  port => '7001',

After that, you will have to use redis-trib.rb to configure your cluster. Check this tutorial .

Note: The main redis_cluster class is required by all other classes (redis_cluster::instance for example). You must declare it whenever you use the module.


This Puppet module is an open project, and community contributions are essential for keeping it great. I can't access the huge number of platforms and myriad hardware, software, and deployment configurations that Puppet is intended to serve. I encourage you to contribute. Send me your pull requests on Github!