Debugging
Redis Issues
Fix Redis connection problems, and what still works while Redis is down.
Fix Redis connection problems, and what still works while Redis is down.
Connection Errors
Cannot Connect to Redis
Check:
- Redis is running:
redis-cli ping - Correct host and port in
REDIS_URLin.env - Network connectivity
- Firewall rules
Solutions:
- Start Redis:
redis-serverordocker compose up redis - Verify the host and port in
REDIS_URL - Test connection:
redis-cli -u "$REDIS_URL" ping - If Redis has a password, check that
REDIS_URLcontains it:redis://:password@host:6379/0
While Redis Is Unreachable
REDIS_URL must be set, but TMA Cloud keeps working while Redis is unreachable:
- Caching is off, so every lookup goes to PostgreSQL and requests are slower
- Live file updates reach only the apps connected to the server process that made the change; changes made by a separate worker process show up on the next refresh
- When Redis is back, the server reconnects by itself and live updates from every process resume
Docker Redis
Container Not Starting
Check:
- The logs:
docker compose logs redis - Port conflicts
- Volume mounts
Solutions:
- Check logs for errors
- Verify port 6379 is available
- Restart container:
docker compose restart redis
Related Topics
- Environment Setup - Redis configuration
- Architecture - System architecture
Last updated on