redis-commander

library0.9.0jsnpmunverified

Redis Commander is a web-based GUI for managing Redis databases, supporting standalone, Sentinel, and Cluster setups. Version 0.9.0 (latest) is stable but in maintenance mode, with no recent active development. It allows viewing, editing, adding, and deleting data of types: strings, lists, sets, sorted sets, streams, and ReJSON documents. Compared to alternatives like RedisInsight, it is lightweight, self-hosted via npm or Docker, and does not require a desktop application. However, it lacks active updates and may have unpatched issues.

database

npm install redis-commander

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · REDIS-COMMANDER

redis-commander

databasejavascriptv0.9.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

redis-commander

✓ import { redisCommander } from 'redis-commander'

✗ const redisCommander = require('redis-commander')

Package does not expose a programmatic API; it is a CLI tool. Use `npx redis-commander` or global install.

default

✓ n/a

No default export; package is meant to be run as a CLI command.

App

✓ n/a

No named exports; the package runs an Express app internally.

Global install and run Redis Commander connecting to local Redis on default port.

npm install -g redis-commander redis-commander --redis-host localhost --redis-port 6379 # Open http://localhost:8081 in browser

Debug

Known issues

breakingNode.js >=12.0 required; older versions cause crashes.

fix

Upgrade Node.js to >=12.0.

affects: <12.0

deprecatedDockerhub images are no longer updated; use ghcr.io/joeferner/redis-commander.

fix

Pull from ghcr.io/joeferner/redis-commander:latest instead.

affects: <0.9.0

gotchaYarn installation is not supported; use npm only.

fix

Use `npm install -g redis-commander`.

affects: *

gotchaRedis Cluster requires --clusters flag or --is-cluster with host/port; otherwise it may connect to a single node only.

fix

Use `redis-commander --clusters host1:6379,host2:6379` or `--is-cluster --redis-host cluster-host --redis-port 6379`.

affects: *

gotchaTLS connections require --redis-tls flag; otherwise connection will fail silently.

fix

Add `--redis-tls` flag and provide CA cert if needed via `--redis-tls-ca-cert`.

affects: *

Errors

Common errors & fixes

Error: Cannot find module 'redis-commander'

Global install not in PATH or not installed.

fix

Run `npm install -g redis-commander` and ensure npm global bin directory is in PATH.

Error: connect ECONNREFUSED 127.0.0.1:6379

Redis server not running on localhost:6379.

fix

Start Redis server or specify correct host/port via `--redis-host` and `--redis-port`.

Error: Redis connection to 127.0.0.1:6379 failed - write EPIPE

Redis server requires TLS but client not configured.

fix

Add `--redis-tls` flag and appropriate TLS options.

Upgrade

Version history

0.9.0latest on npm

Audit

Dependencies

redisrequiredCore dependency for connecting to Redis servers, used in all Redis operations.

expressrequiredWeb server framework serving the GUI.

Agent activity

10 hits · last 30 days

node