Skip to content

Document server_name, valkey_version, and redis_version INFO fields#427

Open
kovan wants to merge 3 commits intovalkey-io:mainfrom
kovan:docs/info-valkey-fields
Open

Document server_name, valkey_version, and redis_version INFO fields#427
kovan wants to merge 3 commits intovalkey-io:mainfrom
kovan:docs/info-valkey-fields

Conversation

@kovan
Copy link
Copy Markdown

@kovan kovan commented Mar 26, 2026

  • Add server_name to the server section field descriptions (it was in the example output but missing from the descriptions list)
  • Expand redis_version description to clarify it is fixed at 7.2.4 across all Valkey releases for client compatibility
  • Expand valkey_version description to recommend using it instead of redis_version

Verified against src/version.h and the PRs referenced in the issue (valkey-io/valkey#232, valkey-io/valkey#47).

Fixes #15

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
- Add server_name field description (was in example output but not
  in the field descriptions list)
- Expand redis_version description to clarify it is fixed at 7.2.4
  and does not change across Valkey releases
- Expand valkey_version description to clarify it is the actual
  version to check

Fixes valkey-io#15
Copy link
Copy Markdown
Contributor

@zuiderkwast zuiderkwast left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! INFO field descriptions look good. Please fix the DCO issue. Click details under the CI job below for more information.

Comment thread commands/info.md
Comment on lines +277 to +279
* `server_name`: The name of the server software (always `valkey` for Valkey servers). Use this field to distinguish Valkey from Redis OSS. Added in Valkey 7.2.5.
* `redis_version`: The Redis OSS version that this Valkey server is compatible with. This value is fixed at `7.2.4` across all Valkey releases to maintain compatibility with existing clients and tools that check this field for feature detection.
* `valkey_version`: The actual Valkey version number (e.g. `8.1.1`). Use this field instead of `redis_version` to check the Valkey version.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The text looks good, but please reorder them to match the order in INFO. They are in this order:

# Server
redis_version:7.2.4
server_name:valkey
valkey_version:255.255.255

We kept redis_version first because of some concerns that some clients or tools might expect it to be first. I don't know if that's true, but the fields should be documented in the same order as they appear in INFO.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is a separate PR for this file. Please keep them separate and skip this file in this PR.

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.

Document INFO valkey_version and server_name

2 participants