VoidCache — Docker Cluster Guide

Architecture

Quick Start

Detailed Setup

Prerequisites

1. Build the image

2. Configuration

3. Start the cluster

4. Verify health

Connecting with Redis Clients

redis-cli (no extra config)

Python (redis-py)

Python cluster client (redis-py cluster)

Node.js (ioredis)

Go (go-redis)

TLS Setup

Step 1: Generate certificates

Step 2: Start with TLS

Step 3: Connect

Operations

Live cluster management

Scale horizontally

Rolling restart (zero downtime)

Inspect data on a node

Backup WAL data

Wipe and restart fresh

Environment Variables Reference

Troubleshooting

"Connection refused" on port 6379

Node stuck in "starting" health status

"NOAUTH Authentication required"

TLS handshake failed

HAProxy shows nodes as DOWN

File Layout