> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prefect.io/llms.txt
> Use this file to discover all available pages before exploring further.

# prefect-redis

## 0.2.12

*Released on June 05, 2026*

**Features**

* Add cleanup reconciler for worker channel delivery [#22205](https://github.com/PrefectHQ/prefect/pull/22205) by [@desertaxle](https://github.com/desertaxle)
* Add Redis cleanup queue backend [#22109](https://github.com/PrefectHQ/prefect/pull/22109) by [@desertaxle](https://github.com/desertaxle)

**Bug Fixes 🐞**

* Add redis-py 8 compatible connection defaults [#22189](https://github.com/PrefectHQ/prefect/pull/22189) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)

**Maintenance**

* Bump `prefect` lower bound to `>=3.7.4`

***

## 0.2.11

*Released on April 24, 2026*

**Enhancements ➕➕**

* Batch-acknowledge Redis stream messages to reduce round-trips [#21622](https://github.com/PrefectHQ/prefect/pull/21622) by [@chuqCTC](https://github.com/chuqCTC)

***

## 0.2.10

*Released on April 03, 2026*

**Features**

* Add `url` field to `RedisMessagingSettings` for single-URL Redis connection configuration via `PREFECT_REDIS_MESSAGING_URL` [#21210](https://github.com/PrefectHQ/prefect/pull/21210) by [@solidnerd](https://github.com/solidnerd)

**Bug Fixes 🐞**

* Log exception before sending message to DLQ in Redis messaging [#21142](https://github.com/PrefectHQ/prefect/pull/21142) by [@HemantDhaker12](https://github.com/HemantDhaker12)
* Move DLQ exception log to `_send_to_dlq` with clearer message [#21144](https://github.com/PrefectHQ/prefect/pull/21144) by [@desertaxle](https://github.com/desertaxle)

***

## 0.2.9

*Released on March 16, 2026*

**Bug Fixes 🐞**

* Mark followers as seen and clean up lost follower Redis keys [#20955](https://github.com/PrefectHQ/prefect/pull/20955) by [@desertaxle](https://github.com/desertaxle)
* Handle orphan Redis pending entries in consumer [#20696](https://github.com/PrefectHQ/prefect/pull/20696) by [@desertaxle](https://github.com/desertaxle)
* Prevent race condition in causal ordering with atomic Lua script [#20386](https://github.com/PrefectHQ/prefect/pull/20386) by [@zzstoatzz](https://github.com/zzstoatzz)
* Fix race condition in ephemeral consumer group cleanup [#20435](https://github.com/PrefectHQ/prefect/pull/20435) by [@zzstoatzz](https://github.com/zzstoatzz)

**Documentation 📝**

* Set up automatic `prefect-redis` API reference docs via `mdxify` [#20713](https://github.com/PrefectHQ/prefect/pull/20713) by [@desertaxle](https://github.com/desertaxle)

***

## 0.2.8

*Released on December 19, 2025*

**Enhancements ➕➕**

* Add retry logic for consumer reconnection on Redis errors [#19817](https://github.com/PrefectHQ/prefect/pull/19817) by [@zzstoatzz](https://github.com/zzstoatzz)
* Unify definition of `EventBeingProcessed` type [#19585](https://github.com/PrefectHQ/prefect/pull/19585) by [@saschwartz](https://github.com/saschwartz)

**Bug Fixes 🐞**

* Fix `anyio` `fail_after` usage [#19583](https://github.com/PrefectHQ/prefect/pull/19583) by [@saschwartz](https://github.com/saschwartz)

***

## 0.2.7

*Released on November 26, 2025*

**Features**

* Parametrize xreadgroup batch size in consumer; Add EventPersister service setting for it [#19545](https://github.com/PrefectHQ/prefect/pull/19545) by [@saschwartz](https://github.com/saschwartz)
* Also parametrize xautoclaim batch size [#19557](https://github.com/PrefectHQ/prefect/pull/19557) by [@saschwartz](https://github.com/saschwartz)

**Breaking Changes**

* Remove Python 3.9 support [#19273](https://github.com/PrefectHQ/prefect/pull/19273) by [@desertaxle](https://github.com/desertaxle)

***

## 0.2.6

*Released on October 16, 2025*

**Features**

* Fix race conditions in concurrency lease renewal [#19187](https://github.com/PrefectHQ/prefect/pull/19187) by [@bunchesofdonald](https://github.com/bunchesofdonald)

***

## 0.2.5

*Released on September 19, 2025*

**Enhancements**

* Update task concurrency slot orchestration rules to work with global concurrency limits [#18983](https://github.com/PrefectHQ/prefect/pull/18983) by [@desertaxle](https://github.com/desertaxle)
* Add pagination support to lease storage `read_active_lease_ids` [#18973](https://github.com/PrefectHQ/prefect/pull/18973) by [@zzstoatzz](https://github.com/zzstoatzz)
* Add `list_holders_for_limit` to `ConcurrencyLeaseStorage` protocol [#18970](https://github.com/PrefectHQ/prefect/pull/18970) by [@zzstoatzz](https://github.com/zzstoatzz)
* Add holder parameter to V2 concurrency endpoints [#18887](https://github.com/PrefectHQ/prefect/pull/18887) by [@zzstoatzz](https://github.com/zzstoatzz)
* Removes followers log from Redis `CausalOrdering` implementation [#18870](https://github.com/PrefectHQ/prefect/pull/18870) by [@desertaxle](https://github.com/desertaxle)
* Update lease storage to include holder indexing and lookup via Lua scripts [#18897](https://github.com/PrefectHQ/prefect/pull/18897) by [@zzstoatzz](https://github.com/zzstoatzz)

***

## 0.2.4

*Released on August 14, 2025*

**Enhancements ➕➕**

* Add Redis-based concurrency lease storage implementation by [@desertaxle](https://github.com/desertaxle) in [#18646](https://github.com/PrefectHQ/prefect/pull/18646)
  * New `ConcurrencyLeaseStorage` class for managing task and flow concurrency limits
  * Atomic lease operations using Redis pipelines
  * Support for lease expiration tracking and management

**Bug Fixes 🐞**

* Fix Redis stream trimming blocked by inactive consumer groups by [@zzstoatzz](https://github.com/zzstoatzz) in [#18642](https://github.com/PrefectHQ/prefect/pull/18642)
  * Added idle threshold checking to prevent abandoned consumer groups from blocking stream trimming
  * Automatic cleanup of empty consumer groups with `ephemeral` prefix
  * New `PREFECT_REDIS_MESSAGING_CONSUMER_TRIM_IDLE_THRESHOLD` setting (default: 5 minutes)

**Development & Tidiness 🧹**

* Bump minimum `prefect` version to 3.4.9 by [@desertaxle](https://github.com/desertaxle) in [#18709](https://github.com/PrefectHQ/prefect/pull/18709)