Registry / database / redis-dump

redis-dump

JSON →
library0.1.10jsnpmunverified

The `redis-dump` package provides a utility for exporting data from a Redis database, offering output in two primary formats: a series of Redis commands suitable for direct re-import via `redis-cli`, or a structured JSON representation for programmatic processing. The current stable version, `0.1.10`, was last published in March 2014, indicating that the project is no longer actively maintained. Its core functionality enables users to backup, migrate, or inspect Redis data, differentiating itself by supporting both a command-line interface and a programmatic API for Node.js applications. Due to its age, it predates modern JavaScript module systems and may not be compatible with newer Redis features or Node.js versions, and has an effectively non-existent release cadence.

database
npm install redis-dump
github ↗package ↗
INSTALL
IMPORT
SIG · REDIS-DUMP
R
redis-dump
databasejavascriptv0.1.10
Install
—
Import
—
Disk
—
Pass rate
0/ 6
Env Coverage0 / 6
glibc
18–22
musl
18–22
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18–226 runs
build_error
glibc
node 18–226 runs
build_error
Code
Verified usage

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

program
✓ const program = require('redis-dump');
✗ import program from 'redis-dump';
The module exports the Commander.js program object used for parsing CLI arguments. It does NOT export a direct function for dumping Redis data programmatically. To utilize its data dumping functionality from Node.js, you must execute the `redis-dump` command as a child process.

This example demonstrates how to use `redis-dump` programmatically by spawning it as a child process to export Redis data in both JSON and Redis command formats, first populating some example data using a modern Redis client.

const redis = require('redis'); const { spawn } = require('child_process'); async function runDump() { const client = redis.createClient({ url: process.env.REDIS_URL || `redis://${process.env.REDIS_HOST || '127.0.0.1'}:${process.env.REDIS_PORT || '6379'}`, password: process.env.REDIS_PASSWORD || '' }); client.on('error', (err) => { console.error('Redis Client Error', err); }); try { await client.connect(); // Populate some dummy data for demonstration await client.del('mydb:numberlist', 'mydb:numberset', 'mydb:numvisits'); await client.rPush('mydb:numberlist', 'one', 'two', 'three'); await client.sAdd('mydb:numberset', 'one', 'two', 'three'); await client.set('mydb:numvisits', '34'); console.log('Dummy data populated in Redis.'); // Define common connection arguments for redis-dump CLI const commonDumpArgs = [ '-h', process.env.REDIS_HOST || '127.0.0.1', '-p', process.env.REDIS_PORT || '6379', '-a', process.env.REDIS_PASSWORD || '', '-f', 'mydb:*' ]; // Dump as JSON console.log('\n--- Dumping as JSON ---'); const jsonDumpProcess = spawn('redis-dump', [...commonDumpArgs, '--json', '--pretty']); let jsonOutput = ''; jsonDumpProcess.stdout.on('data', (data) => { jsonOutput += data.toString(); }); jsonDumpProcess.stderr.on('data', (data) => { console.error(`stderr (JSON dump): ${data}`); }); await new Promise((resolve, reject) => { jsonDumpProcess.on('close', (code) => { if (code === 0) { console.log('JSON Dump Output:\n', jsonOutput); resolve(); } else { reject(new Error(`redis-dump JSON process exited with code ${code}`)); } }); }); // Dump as Redis commands console.log('\n--- Dumping as Redis Commands ---'); const commandDumpProcess = spawn('redis-dump', commonDumpArgs); let commandOutput = ''; commandDumpProcess.stdout.on('data', (data) => { commandOutput += data.toString(); }); commandDumpProcess.stderr.on('data', (data) => { console.error(`stderr (Command dump): ${data}`); }); await new Promise((resolve, reject) => { commandDumpProcess.on('close', (code) => { if (code === 0) { console.log('Command Dump Output:\n', commandOutput); resolve(); } else { reject(new Error(`redis-dump Command process exited with code ${code}`)); } }); }); } catch (error) { console.error('An error occurred:', error); } finally { await client.disconnect(); console.log('Redis client disconnected.'); } } runDump();
redis-dump --version
Debug
Known issues
breakingThe `redis-dump` package is effectively abandoned, with its last publication dating back to March 2014. It is unlikely to be compatible with newer Node.js versions, modern Redis client libraries, or recent Redis server features and data structures, potentially leading to instability or data loss.
fix
Consider using actively maintained alternatives like `ioredis` or `node-redis` for programmatic dumping and backup solutions. For CLI-based backups, `redis-cli --rdb` or `redis-cli --scan | xargs redis-cli dump` provide more robust and current options.
affects: <=0.1.10
gotchaDespite its description, programmatic usage of `redis-dump` in Node.js is primarily achieved by spawning its command-line interface as a child process (e.g., using `child_process.spawn`). The `require('redis-dump')` statement directly exposes the Commander.js CLI parser object, not a direct function for dumping Redis data.
fix
When integrating `redis-dump` into a Node.js application, use `require('child_process').spawn('redis-dump', args)` to execute the CLI tool with desired arguments, rather than attempting to call methods directly from the required module.
affects: <=0.1.10
gotchaThe package defaults to connecting to a Redis server on `127.0.0.1:6379` without authentication. If your Redis instance is configured differently, requires a password, or is not running on the default host/port, you must explicitly provide the correct hostname, port, and authentication parameters via the command line arguments (`-h`, `-p`, `-a`).
fix
Always specify connection details explicitly: `redis-dump -h <host> -p <port> -a <password>`. Use environment variables or a configuration management system to securely handle sensitive data like passwords.
affects: <=0.1.10
gotchaWhen generating Redis commands, the output includes `DEL` commands before `RPUSH`, `SADD`, `ZADD`, `HMSET`, etc. This behavior ensures a clean slate upon re-import but will unconditionally delete and then recreate keys with matching names, potentially overwriting existing data if not handled carefully.
fix
Be aware that importing a generated Redis command dump will overwrite existing data for keys present in the dump. If you need to merge data or selectively restore, manual processing or filtering of the dump file is necessary before importing.
affects: <=0.1.10
Errors
Common errors & fixes
"redis-dump" is not recognized as an internal or external command, operable program or batch file.
The `redis-dump` CLI tool is not found in your system's PATH. This typically occurs if the package was installed locally (`npm install redis-dump`) but not globally (`npm install -g redis-dump`), or if `node_modules/.bin` is not in your PATH.
fix
Install the package globally using `npm install -g redis-dump`. Alternatively, execute it using `npx redis-dump [OPTIONS]` or by referencing its local binary path: `$(npm bin)/redis-dump [OPTIONS]`.
Error: connect ECONNREFUSED 127.0.0.1:6379
The `redis-dump` tool failed to establish a connection to the Redis server. This usually means the Redis server is not running, is configured to listen on a different host or port, or is blocked by a firewall.
fix
Ensure your Redis server is running and accessible from the machine where `redis-dump` is executed. Verify the host, port, and password by explicitly passing them to `redis-dump` using the `-h`, `-p`, and `-a` arguments.
SyntaxError: Unexpected token 'export' or 'import' in redis-dump.js
You are attempting to use `redis-dump`, which is a CommonJS module from 2014, with ES module `import` syntax in a modern Node.js environment or build setup that does not correctly transpile or handle CommonJS imports.
fix
Use CommonJS `require()` syntax to load the module: `const program = require('redis-dump');`. Direct programmatic use of its dumping functionality is limited, as the module exports the Commander.js program object rather than a dump function.
Upgrade
Version history
0.1.10latest on npm
Audit
Dependencies

No dependency data recorded yet.

Agent activity
4 hits · last 30 days
node
4
Resources
githubhttps://github.com/jeremyfa/node-redis-dump ↗
packagehttps://www.npmjs.com/package/redis-dump ↗
redis-dump — npm install redis-dump · libregistry