llms.txt
Search Documentation
Search through all documentation pages
Setup Guide

Redis Setup

Configure Redis for queues, caching, and scheduling in Kener

Redis is required. Kener will not start without REDIS_URL.

Quick configuration

Add this to .env:

REDIS_URL=redis://localhost:6379

Use rediss:// when your provider requires TLS.

Minimum server sizing (CPU/RAM)

Note

Based on practical Kener v4 deployments (app + Redis + relational DB). If monitor count and alert volume grow, scale up.

Redis service sizing

Workload vCPU RAM
Minimum shared / 0.25+ 128MB
Recommended 0.5+ 256MB
Higher load 1+ 512MB+

Kener app sizing impact (with Redis enabled)

Workload vCPU RAM
Minimum 1 512MB
Recommended 1 1GB
Higher load 2+ 2GB+

Connection formats

redis://[username:password@]host[:port][/database]
rediss://[username:password@]host[:port][/database]

Examples:

REDIS_URL=redis://localhost:6379
REDIS_URL=redis://:password@localhost:6379
REDIS_URL=rediss://default:password@your-endpoint:6379

Requirements

  • Redis 6.0+ (7.0+ recommended)
  • Standard read/write commands enabled
  • Network access from Kener to Redis host/port

Verify connection

redis-cli -u $REDIS_URL ping

Expected response: PONG

Troubleshooting

  • REDIS_URL is not defined: add REDIS_URL to .env and restart.
  • NOAUTH Authentication required: include password in the URL.
  • Connection timeout: verify host/port/firewall and Redis service status.
  • READONLY: connect to primary/writer instance, not a read replica.

Environment variables

Variable Description Default Required
REDIS_URL Redis connection string None Yes

Free Redis SaaS options (indie-friendly)

If you want a managed Redis/Valkey service without running your own server:

Provider Free option Best for Quick notes
Railway Redis Free usage via Railway trial credits Fast demos and MVPs Very easy setup; credit-based (not permanent free tier)
Upstash Free tier (serverless, request-based) Side projects and low-traffic apps Great DX; works well for serverless/edge
Aiven for Valkey Free managed Valkey plan Persistent dev/test environments Redis-compatible Valkey; simple managed setup

Note

Free limits and pricing change over time. Check each provider’s current limits before production use.