Redis Connection Refused: Diagnose and Fix in 5 Steps

Redis Connection Refused: Diagnose and Fix in 5 Steps Error: Redis connection to 127.0.0.1:6379 failed - connect ECONNREFUSED 127.0.0.1:6379 Your caching layer is down, your app is throwing errors, and you need to fix it fast. Here's the systematic way to diagnose and resolve Redis connection failures. Step 1: Is Redis Actually Running? # Check if Redis process exists ps aux | grep redis # Check systemd service status sudo systemctl status redis sudo systemctl status redis-server # Ubuntu/Debian # Check if it's listening on the port ss -tlnp | grep 6379 If Redis is stopped: sudo systemctl start redis-server sudo systemctl enable redis-server # Auto-start on boot Step 2: Test the Connection Directly # Basic ping test redis-cli ping # Expected: PONG # If using a password (requirepass) redis-cli -a your_password ping # If Redis is on a different host redis-cli -h your-redis-host -p 6379 ping If redis-cli works but your app can't connect — the problem is in your app's connection config, no