Error: celery cannot connect to redis

What's Causing This Error

The error 'celery cannot connect to redis' typically happens when the Celery task queue library in Python is unsuccessful in initiating a connection with Redis, an in-memory data structure store. The failure to connect can stem from various factors such as incorrect configuration settings, problems with network connectivity, or Redis server downtime.

If for some reason, the Redis server isn't operational, the connection attempt made by Celery will fail, resulting in this error. Similarly, discrepancies in Redis configurations such as the instance not listening on the anticipated port, or a mismatch in the password set in its configuration compared to the Celery configuration, can cause the connection to fail. Network connectivity problems span firewall interference, proxy servers, and DNS resolution issues, which can prevent Celery from establishing a connection with Redis.

Solution - Here's How To Resolve It

  1. Check Redis server status: Ensure that the Redis server is operational and reachable. You can confirm this by trying to manually connect to Redis using the Redis command-line tool or a Redis client library from where Celery is hosted. If you're unable to establish a connection, ensure Redis is correctly installed and running on the expected host and port.

  2. Verify Celery configuration: Go over your Celery setup to make sure that the host and port settings align with the ones for your Redis server. You'll usually find these settings in a configuration file named either or, depending on your particular setup. Verify that the BROKER_URL or CELERY_BROKER_URL setting reflects accurate Redis connection details.

  3. Check authentication settings: If your Redis server necessitates authentication, verify that you have specified the correct credentials in your Celery configuration. Specifically, check if the BROKER_PASSWORD or CELERY_BROKER_PASSWORD setting aligns with the Redis authentication password.

  4. Verify firewall and security groups: Make sure no firewall rules or security group settings are hindering the connection between Celery and Redis. Confirm that the necessary network ports (usually 6379 for Redis) are open for communication. If you're unsure, consult with your system administrator or review your network configuration to verify if there are any obstructions in place.

  5. Test connectivity from the command line: Try manually connecting to Redis using the Redis command-line tool from where Celery is hosted. Execute the command below, replacing <redis_host> and <redis_port> with your specific values:

redis-cli -h <redis_host> -p <redis_port>

A successful connection will render a Redis command prompt; failure indicates a connectivity problem between your machine and the Redis server.

  1. Review logs and error messages: Inspect the logs and error messages produced by Celery for any distinct error messages related to the failed connection. Celery typically logs to stdout, so check the output in the terminal where you initiated Celery or in any log files you've configured.

  2. Verify Redis configuration: Review the Redis configuration file (redis.conf) and confirm that it's set up to accept external connections and listen on the correct network interface. Search for the bind directive and ensure it's set to the suitable IP address or to allow listening on all interfaces.

  3. Restart services: As a last resort, try restarting both the Celery and Redis services as occasionally, a simple restart can resolve temporary issues.

Was this content helpful?

Start building today

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.