Skip to content
Cnone-Tech Documentation

Redis connection failed

Cnone-Tech DocsVeldriq

Symptom: Redis connection refused; cache/session/queue errors after you pointed drivers at Redis.

Likely cause: Redis not installed; TCP vs Unix socket; REDIS_PORT not 0 for sockets.

Redis is optional. Defaults remain database. You do not need Redis to run Veldriq.

Check

Section titled “Check”
  1. Did you set CACHE_STORE, SESSION_DRIVER, or QUEUE_CONNECTION to redis without a working Redis?
  2. Unix socket: REDIS_PORT=0. A leftover TCP port with a socket path fails.
  3. After ENV changes: php artisan config:clear and php artisan queue:restart.

Fix

Section titled “Fix”
  • Switch back to database drivers, or fix host/socket.
  • sync queue is not a Redis substitute for production mail/PDFs.

Related: Redis, Queue.