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: addREDIS_URLto.envand 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.