NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io, #844 most downloaded on crates.io
Redis driver for Rust.
Latest stable
1.8.1
Last release 17 days ago
30 Oct 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
26 versions withdrawn
withdrawn after publishing
12 years old
128 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
fixup dependency on never type fallback to unit (#2060 @WaffleLapkin)
Fix explicit IoError not being recognized
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Handle empty results in multi-node operations
MultiplexedConnection: Separate response handling for pipeline.
Fix small disambiguity in examples (#1072 @sunhuachuang)
Update mio dependency due to vulnerability
fixup dependency on never type fallback to unit
Breaking change: Support Mutual TLS (#858 @sp-angel)
FromRedisValue for Box<[T]> and Arc<[T]> (#799 @JOT85)tcp_nodelay feature (#941 @PureWhiteWu)load_native_certs. (#996)ClusterClient initialization (#987 @ruanpetterson)tokio in their name. (#913)FromRedisValue for Box<[T]> and Arc<[T]> (#799 by @JOT85)tcp_nodelay feature (#941 by @PureWhiteWu)load_native_certs. (#996)ClusterClient initialization (#987 by @ruanpetterson)tokio in their name. (#913)fixup dependency on never type fallback to unit (#2058 @WaffleLapkn)
Yanked -- Inadvertently introduced breaking changes (sorry!). The changes in this tag have been pushed to 0.24.0.
Yanked -- Inadvertently introduced breaking changes (sorry!). The changes in this tag have been pushed to 0.24.0.
Note that this release fixes a small regression in async Redis Cluster handling of the PING command. Based on updated response aggregation logic in #8
Note that this release fixes a small regression in async Redis Cluster handling of the PING command.
Based on updated response aggregation logic in #888, it
will again return a single response instead of an array.
Rustls: Remove usage of deprecated method
Add basic Sentinel functionality (#836 @felipou)
tempfile dependency (#902)set_options cmd (#879 @RokasVaitkevicius)redis-macros (#769 @daniel7grant)tempfile dependency (#902)set_options cmd (#879 by @RokasVaitkevicius)redis-macros (#769 by @daniel7grant)<a name="0.23.0"></a>
Type bounds for AsyncIter have changed slightly, making this a potentially breaking change. (#597 @roger)
This release adds the cluster_async module, which introduces async Redis Cluster support. The code therein is largely taken from @Marwes's redis-cluster-async crate, which itself appears to have started from a sync Redis Cluster mplementation started by @atuk721. In any case, thanks to @Marwes and @atuk721 for the great work, and we hope to keep development moving forward in redis-rs.
This release also adds support for Rustls, a long-sought feature. Thanks to @rharish101 and @LeoRowan for getting this in! Note that the tls and async-std-tls-comp features have been deprecated and replaced by tls-native-tls and async-std-native-tls-comp, respectively.
Though async Redis Cluster functionality for the time being has been kept as close to the originating crate as possible, previous users of
redis-cluster-async should note the following changes:
None/infinite retriesredis-rs functionalityClusterClientConnection to ClusterConnectionAsyncIter's stream implementation in which polling the server
for additional data yielded broken data in most cases. Type bounds for AsyncIter have changed slightly,
making this a potentially breaking change. (#597 @roger)mset / deprecate set_multiple (#766 @randomairborne)MultiplexedConnection and ConnectionManager (#811 @nihohit)cluster_async: rename Connection to ClusterConnection, Pipeline to ClusterConnInner (#808)cluster::ClusterConnection underlying connection type is now generic (with existing type as default)read_from_replicas in cluster_asyncClusterClientBuilderclustercluster: Tls Builder support / simplify cluster connection map (#718 @0xWOF, @utkarshgupta137)In addition to everything mentioned in 0.23.0-beta.1 notes, this release adds support for Rustls, a long- sought feature. Thanks to @rharish101 and @LeoRowan for getting this in!
<a name="0.23.0-beta.1"></a>
Type bounds for AsyncIter have changed slightly, making this a potentially breaking change. (#597 by @roger)
This release adds the cluster_async module, which introduces async Redis Cluster support. The code therein
is largely taken from @Marwes's redis-cluster-async crate, which itself
appears to have started from a sync Redis Cluster implementation started by @atuk721. In any case, thanks to @Marwes and @atuk721
for the great work, and we hope to keep development moving forward in redis-rs.
Though async Redis Cluster functionality for the time being has been kept as close to the originating crate as possible, previous users of
redis-cluster-async should note the following changes:
None/infinite retriesredis-rs functionalityClusterClientConnection to ClusterConnectionAsyncIter's stream implementation in which polling the server
for additional data yielded broken data in most cases. Type bounds for AsyncIter have changed slightly,
making this a potentially breaking change. (#597 by @roger)mset / deprecate set_multiple (#766 by @randomairborne)MultiplexedConnection and ConnectionManager (#811 by @nihohit)cluster_async: rename Connection to ClusterConnection, Pipeline to ClusterConnInner (#808)cluster::ClusterConnection underlying connection type is now generic (with existing type as default)read_from_replicas in cluster_asyncClusterClientBuilderclustercluster: Tls Builder support / simplify cluster connection map (#718 by @0xWOF, @utkarshgupta137)<a name="0.22.4"></a>
fixup dependency on never type fallback to unit
<a name="0.22.3"></a>
Fixes regression in 0.22.2 related to removed ClusterConnection::check_connection method. Thanks to @robjtede for identifying and fixing!
Fixes regression in 0.22.2 related to removed ClusterConnection::check_connection method. Thanks to @robjtede for identifying and fixing!
ClusterConnection::check_connection() method (#758 @robjtede)ClusterConnection::check_connection() method (#758 by @robjtede)<a name="0.22.2"></a>
This release adds various incremental improvements and fixes a few long-standing bugs. Thanks to all our contributors for making this release happen.
This release adds various incremental improvements and fixes a few long-standing bugs. Thanks to all our contributors for making this release happen.
MGET command (#729 @vamshiaruru-virgodesigns)get responses (#507 @hank121314)This release adds various incremental improvements and fixes a few long-standing bugs. Thanks to all our contributors for making this release happen.
MGET command (#729 by @vamshiaruru-virgodesigns)get responses (#507 by @hank121314)<a name="0.22.1"></a>
Add README attribute to Cargo.toml
Although the changes here are incremental, this is a major release due to the breaking changes listed below.
Redis-rs is a high level redis library for Rust and aims to provide convenient access to all Redis functionality through a very flexible but low-level API. The crate has recently come under maintainership by @djc and @jaymell. Much appreciation and many thanks to @mitsuhiko, @badboy, @Marwes for their work in building this library over the years! The new maintainers hope to improve the velocity of bug fixes, new features, and PR reviews in the coming months.
This release adds various incremental improvements, including additional convenience commands, improved Cluster APIs, and various other bug fixes/library improvements.
Although the changes here are incremental, this is a major release due to the breaking changes listed below.
This release would not be possible without our many wonderful contributors -- thank you!
sha1 feature (#576)ahash feature for using ahash internally & for redis values (#636 @utkarshgupta137)This release adds various incremental improvements, including additional convenience commands, improved Cluster APIs, and various other bug fixes/library improvements.
Although the changes here are incremental, this is a major release due to the breaking changes listed below.
This release would not be possible without our many wonderful contributors -- thank you!
sha1 feature (#576)ahash feature for using ahash internally & for redis values (#636 by @utkarshgupta137)<a name="0.21.8"></a>
0.21.8: fixup dependency on never type fallback to unit #2072
0.21.8: fixup dependency on never type fallback to unit #2072
<a name="0.21.7"></a>
This release addresses bugs related to server response parsing and MultiPlexedConnection error handling.
<a name="0.21.7"></a>
This release addresses bugs related to server response parsing and MultiPlexedConnection error handling.
* Update dependencies
<a name="0.21.5"></a>
#### Features * Add new list commands
Add convenience command: zrandbember
Add support for TLS with cluster mode
Compile with tokio-comp and up-to-date dependencies (282f997e, closes #531, breaks #)
pin futures dependency to required version
Don't enqueue multiplexed commands if the receiver is dropped
<a name="0.20.2"></a>
Nothing published for this version
Provide a new_async_std function
BREAKING CHANGE: The parser type now only persists the buffer and takes the Read instance in parse_value
<a name="0.20.0"></a>
<a name="0.19.0"></a>
<a name="0.18.0"></a>
Don't require tokio for the connection manager (46be86f3)
Make ToRedisArgs and FromRedisValue consistent for booleans
BREAKING CHANGE
bool are now written as 0 and 1 instead of true and false. Parsing a bool still accept true and false so this should not break anything for most users however if you are reading something out that was stored as a bool you may see different results.
Fixes and improvements
Value conversions (#327)Fixes and improvements
parse_valueNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Breaking change: rename parse_async to parse_redis_value_async for consistency (ce59cecb).
Fixes and improvements
parse_async to parse_redis_value_async for consistency (ce59cecb).Script#invoke_async generic over aio::ConnectionLike (#242)parse_async to parse_redis_value_async for consistency (ce59cecb).If you used redis::parse_async before, you now need to change this to redis::parse_redis_value_async
or import the method under the new name: use redis::parse_redis_value_async.
Script#invoke_async generic over aio::ConnectionLike (#242)Script#invoke_async was changed to be generic over aio::ConnectionLike in order to support wrapping a SharedConnection in user code.
This required adding a new generic parameter to the method, causing an error when the return type is defined using the turbofish syntax.
Old:
redis::Script::new("return ...")
.key("key1")
.arg("an argument")
.invoke_async::<String>()
New:
redis::Script::new("return ...")
.key("key1")
.arg("an argument")
.invoke_async::<_, String>()
Breaking change: Use dyn keyword to avoid deprecation warning
Fixes and improvements
dyn keyword to avoid deprecation warning (#223)Script::invoke_async return type error (#233)GETRANGE and SETRANGE commands (#202)SINTERSTORE wrapper name, it's now correctly sinterstore (#225)SharedConnection with any other runtime (#229)dyn keyword to avoid deprecation warning (#223)Rust nightly deprecated bare trait objects.
This PR adds the dyn keyword to all trait objects in order to get rid of the warning.
This bumps the minimal supported Rust version to Rust 1.27.
We updated the url dependency to v2. We do expose this on our public API on the redis::parse_redis_url function. If you depend on that, make sure to also upgrade your direct dependency.
Previously, invoking a script with a complex return type would cause the following error:
Response was of incompatible type: "Not a bulk response" (response was string data('"4b98bef92b171357ddc437b395c7c1a5145ca2bd"'))
This was because the Future returned when loading the script into the database returns the hash of the script, and thus the return type of String would not match the intended return type.
This commit adds an enum to account for the different Future return types.
This release includes all fixes & improvements from the two beta releases listed below. This release contains breaking changes.
This release includes all fixes & improvements from the two beta releases listed below. This release contains breaking changes.
Fixes and improvements
tokio_sync's channels instead of futures (#195)async is a reserved keyword in Rust 2018, so this avoids the need to write r#async in it.
Old code:
use redis::async::SharedConnection;
New code:
use redis::aio::SharedConnection;
ToRedisArgs was changed (#165)ToRedisArgs has been changed to take take an instance of RedisWrite instead of Vec<Vec<u8>>. Use the write_arg method instead of Vec::push.
Upgrade your compiler.
impl Iterator is used, requiring a more recent version of the Rust compiler.
iter now takes self by value (#165)iter now takes self by value instead of cloning self inside the method.
Old code:
let mut iter : redis::Iter<isize> = cmd.arg("my_set").cursor_arg(0).iter(&con).unwrap();
New code:
let mut iter : redis::Iter<isize> = cmd.arg("my_set").cursor_arg(0).clone().iter(&con).unwrap();
(The above line calls clone().)
We removed the internal usage of RefCell and Cell and instead require a mutable reference, &mut ConnectionLike,
on all command calls.
Old code:
let client = redis::Client::open("redis://127.0.0.1/")?;
let con = client.get_connection()?;
redis::cmd("SET").arg("my_key").arg(42).execute(&con);
New code:
let client = redis::Client::open("redis://127.0.0.1/")?;
let mut con = client.get_connection()?;
redis::cmd("SET").arg("my_key").arg(42).execute(&mut con);
Due to this, transaction has changed. The callback now also receives a mutable reference to the used connection.
Old code:
let client = redis::Client::open("redis://127.0.0.1/").unwrap();
let con = client.get_connection().unwrap();
let key = "the_key";
let (new_val,) : (isize,) = redis::transaction(&con, &[key], |pipe| {
let old_val : isize = con.get(key)?;
pipe
.set(key, old_val + 1).ignore()
.get(key).query(&con)
})?;
New code:
let client = redis::Client::open("redis://127.0.0.1/").unwrap();
let mut con = client.get_connection().unwrap();
let key = "the_key";
let (new_val,) : (isize,) = redis::transaction(&mut con, &[key], |con, pipe| {
let old_val : isize = con.get(key)?;
pipe
.set(key, old_val + 1).ignore()
.get(key).query(&con)
})?;
rustc-serialize feature (#200)We removed serialization to/from JSON. The underlying library is deprecated for a long time.
Old code in Cargo.toml:
[dependencies.redis]
version = "0.9.1"
features = ["with-rustc-json"]
There's no replacement for the feature. Use serde and handle the serialization/deserialization in your own code.
with-unix-sockets feature (#201)We removed the Unix socket feature. It is now always enabled. We also removed auto-detection.
Old code in Cargo.toml:
[dependencies.redis]
version = "0.9.1"
features = ["with-unix-sockets"]
There's no replacement for the feature. Unix sockets will continue to work by default.
Nothing published for this version
Nothing published for this version
Fix handling of passwords with special characters
clear method to the pipeline (#176)Nothing published for this version
Some time has passed since the last release. This new release will bring less bugs, more commands, experimental async support and better performance.
Some time has passed since the last release. This new release will bring less bugs, more commands, experimental async support and better performance.
Highlights:
The async support is currently experimental.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.