error fix

n8n Redis Connection Error: Fix Queue Mode Host, Port, Password, and Workers

A Redis connection error in n8n usually affects queue mode and means the main process or workers cannot reach Redis with the configured host, port, credentials, or network route.

Primary query: n8n redis connection error Intent: troubleshooting Applies to: self-hosted, queue mode, Redis Opportunity: 92 Source-backed draft

Independent third-party notes. n8n is a trademark of its owner and is referenced only for compatibility and troubleshooting context.

Quick Answer

A Redis connection error in n8n usually affects queue mode and means the main process or workers cannot reach Redis with the configured host, port, credentials, or network route.

Problem Pattern

Queue mode cannot dispatch or process executions because one or more n8n processes cannot connect to Redis.

Key Facts

Redis role: Redis holds queued execution IDs for queue mode.
Default port: Redis commonly uses port 6379.
Required reachability: Main and worker processes must all reach Redis.
Credentials: Username, password, database, and TLS/network settings must match the Redis deployment.

Recommended Steps

Confirm Redis is running and reachable on the expected host and port.
Check QUEUE_BULL_REDIS_HOST and QUEUE_BULL_REDIS_PORT.
Check Redis username, password, and database variables if used.
Test network connectivity from the n8n main container and worker containers.
Restart n8n processes after changing Redis environment variables.

Verification

n8n logs show successful Redis connection.
Workers pick up queued executions.
Redis connection errors disappear from both main and worker logs.

Warnings

Do not expose Redis publicly to solve container networking.
If only workers cannot connect, compare worker environment variables against the main process.

Common Mistakes

Using localhost from inside a container.
Configuring Redis for the main process but not workers.
Forgetting Redis password or database index in one service.
Changing Redis host without restarting all n8n processes.

Examples

Redis variable check Keep these consistent across queue-mode processes.

QUEUE_BULL_REDIS_HOST=redis
QUEUE_BULL_REDIS_PORT=6379
QUEUE_BULL_REDIS_USERNAME=
QUEUE_BULL_REDIS_PASSWORD=change-me
QUEUE_BULL_REDIS_DB=0

FAQ

Does n8n need Redis outside queue mode?

Redis is specifically central to queue mode. If you are not using queue mode, troubleshoot the actual node or database error first.

Why does Redis work locally but not in Docker Compose?

The host name changes. In Compose, use the Redis service name on the shared network rather than localhost.

Sources

n8n Queue Mode Accessed 2026-05-08