Change8

Migrating to Celery v5.6.0b2

Version v5.6.0b2 introduces 2 breaking changes. This guide details how to update your code.

Released: 10/20/2025

2
Breaking Changes
5
Migration Steps
6
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

RedisBackendcelery.timezonedisable_prefetchgroup.replace_signatureMSSQLResultBackendbroker connection retry logging

Breaking Changes

Issue #1

Support for Python 3.8 has been removed; projects must upgrade to Python 3.9 or newer.

Issue #2

Python version requirement has been raised to >=3.9, which may break environments still on older versions.

Migration Steps

  1. 1
    Upgrade your runtime to Python 3.9 or newer.
  2. 2
    If you were using Python 3.8, update your CI, Dockerfiles, and tox configurations accordingly.
  3. 3
    Remove any usage of backports.zoneinfo as it is no longer required.
  4. 4
    If you relied on disable-prefetch with non-Redis brokers, adjust your configuration because the feature now works only with Redis.
  5. 5
    Review any custom RedisBackend usage to handle the new credential_provider option.

Release Summary

Celery 5.6.0b2 introduces Redis credential provider support, improved timezone handling, and several bug fixes while raising the minimum Python requirement to 3.9 and removing Python 3.8 support.

Need More Details?

View the full release notes and all changes for Celery v5.6.0b2.

View Full Changelog