Skip to content
Home / Migrations / Redis (redis npm)Valkey (iovalkey)

Redis (redis npm) Valkey (iovalkey)

easy

Redis changed its license to non-OSS in 2024. Valkey is the Linux Foundation fork with identical API. Drop-in replacement.

Estimated: 1-2h · 4 steps
Progress0%
Step 1: Replace npm package

iovalkey is the Valkey client, API-compatible with ioredis.

npm uninstall ioredis && npm install iovalkey
Step 2: Update imports

Change import source only. All Redis commands are identical.

// Before: import Redis from 'ioredis'
// After: import Redis from 'iovalkey'
Step 3: Update connection string

Point to your Valkey instance (or AWS ElastiCache Valkey cluster) instead of Redis endpoint.

Step 4: Verify commands

Test SET, GET, HSET, LPUSH, SUBSCRIBE — all Valkey commands match Redis 7.2.

All cache operations work as before