Skip to content

Add Redis compatibility reference page#426

Open
kovan wants to merge 3 commits intovalkey-io:mainfrom
kovan:docs/redis-compatibility
Open

Add Redis compatibility reference page#426
kovan wants to merge 3 commits intovalkey-io:mainfrom
kovan:docs/redis-compatibility

Conversation

@kovan
Copy link
Copy Markdown

@kovan kovan commented Mar 26, 2026

Add a new topics/redis-compatibility.md page covering:

  1. Version compatibility - forked from Redis 7.2.4, compatible with all Redis OSS up to 7.2.x, not with Redis CE 7.4+
  2. INFO fields - redis_version fixed at 7.2.4 for client compat, server_version for actual Valkey version
  3. Lua scripting - both redis.call() and server.call() namespaces work
  4. Module API - both RedisModule_* and ValkeyModule_* prefixes supported
  5. Protocol - RESP2/RESP3 compatible, all Redis client libraries work
  6. Persistence - same RDB/AOF format as Redis OSS 7.2
  7. Configuration - existing redis.conf files work as-is
  8. CLI - redis-cli works with Valkey and vice versa

All information verified against the Valkey source code.

Fixes #14

kovan added 3 commits March 26, 2026 21:05
Document how Valkey maintains backward compatibility with Redis OSS:

1. Version compatibility: forked from Redis 7.2.4, compatible with
   all Redis OSS versions up to 7.2.x, not compatible with Redis CE 7.4+
2. INFO fields: redis_version is fixed at 7.2.4 for client compatibility,
   server_version reports the actual Valkey version
3. Lua scripting: both redis.call() and server.call() namespaces work
4. Module API: both RedisModule_* and ValkeyModule_* prefixes are supported

All information verified against the Valkey source code (version.h,
redismodule.h, valkeymodule.h).

Fixes valkey-io#14
- Fix: the INFO field is valkey_version, not server_version
  (renamed in valkey-io/valkey#232)
- Add Lua globals: SERVER_NAME, SERVER_VERSION, SERVER_VERSION_NUM
  (added in valkey-io/valkey#47)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create doc page outlining Redis and Valkey compatibility

1 participant