Core Methods to Fix Redis Connection Refused Error in Django on Heroku

When developing Django applications, many developers use Redis for caching or message queuing. In local environments, Redis typically runs on localhost:6379, but when deploying to Heroku, platform constraints require configuring external Redis services.

Problem Background

The error message "Error 111 connecting to localhost:6379. Connection refused" often appears in Heroku deployments, indicating that the application is attempting to connect to a local Redis instance, whereas in cloud environments, Redis services are provided via add-ons like Redis To Go.

Error Analysis

The core issue is that the application does not correctly read the REDISTOGO_URL environment variable. On Heroku, the connection URL for Redis services is stored in this environment variable; if not set or used, the application defaults to localhost:6379, causing connection refusal.

Solution

Based on best practices, the solution is to ensure the application retrieves the Redis URL from the environment variable. The following code example demonstrates the correct configuration method:

import os
import urlparse
from redis import Redis

redis_url = os.getenv('REDISTOGO_URL')
if not redis_url:
    raise RuntimeError('Set up Redis To Go first.')

urlparse.uses_netloc.append('redis')
url = urlparse.urlparse(redis_url)
conn = Redis(host=url.hostname, port=url.port, db=0, password=url.password)

By implementing this, the application will use the Redis service provided by Heroku instead of attempting to connect to localhost. Ensure that the REDISTOGO_URL variable is set in the Heroku configuration and used as shown in the code.

Additional Notes

Other answers mention installing and starting Redis servers, such as via sudo apt-get install redis-server, but this is primarily relevant for local development environments. In the Heroku context, Redis is an external service, and no installation is required on the server; the focus should be on environment variable configuration.

Conclusion

Proper handling of environment variables is crucial when deploying Django applications to Heroku. By utilizing REDISTOGO_URL, developers can avoid connection errors and ensure stable application performance in cloud environments. Additionally, regularly checking environment variable settings and code logic can prevent similar issues.