Help us improve
Share bugs, ideas, or general feedback.
From render
Provisions and configures Render Key Value (Redis-compatible Valkey 8) instances for caching, session storage, and job queues. Use for Redis/Valkey setups, maxmemory policies, ipAllowList, and internal/external connections.
npx claudepluginhub render-oss/skills --plugin renderHow this skill is triggered — by the user, by Claude, or both
Slash command
/render:render-keyvalueThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Render Key Value provides low-latency, Redis-compatible in-memory storage running **Valkey 8**. Use it as a shared cache, session store, or job queue backend. Compatible with virtually all Redis client libraries.
Guides Redis system design: data structures for caching, queues, leaderboards, sessions; caching strategies, pub/sub, streams, clustering, memory optimization, Lua scripting.
Provides deep operational guidance for 15 key-value stores including Redis/Valkey (cluster, Streams), DynamoDB (single-table), etcd, and more. Use for production configuration, tuning, operations.
Redis patterns for caching, rate limiting, distributed locks, session storage, Pub/Sub, and connection management in production applications.
Share bugs, ideas, or general feedback.
Render Key Value provides low-latency, Redis-compatible in-memory storage running Valkey 8. Use it as a shared cache, session store, or job queue backend. Compatible with virtually all Redis client libraries.
For background worker setup and queue framework patterns, see render-background-workers. For Blueprint authoring, see render-blueprints.
New instances run Valkey 8, an open-source Redis fork. It is a drop-in replacement for Redis—existing Redis client libraries work without changes. Legacy instances (created before Feb 2025) run Redis 6.
Every instance has two URLs:
| URL type | When to use | Auth required |
|---|---|---|
Internal (redis://red-xxx:6379) | From Render services in the same region | No (by default) |
External (rediss://red-xxx:6379) | From outside Render (local dev, CI) | Always |
Always prefer the internal URL for production services—lower latency, no TLS overhead, communicates over the private network.
External connections are disabled by default. Enable them by adding IP ranges to the access control list in the Dashboard.
By default, internal connections are unauthenticated. You can require auth for internal connections in the Dashboard for compliance or extra security. This changes the internal URL to include credentials:
redis://default:PASSWORD@red-xxx:6379
Warning: Enabling internal auth breaks existing unauthenticated connections. Migrate clients to the authenticated URL first.
Critical decision. Choose based on your use case:
| Use case | Policy | Why |
|---|---|---|
| Cache (can lose data) | allkeys-lru | Evicts least-recently-used keys to free space |
| Job queue (cannot lose data) | noeviction | Returns error on writes when full; never drops keys |
| Session store | allkeys-lru or volatile-lru | Sessions can be regenerated; LRU is safe |
All available policies:
| Policy | Behavior | Memory fills up? |
|---|---|---|
allkeys-lru | Evict any key by LRU | No |
noeviction | Error on writes when full | Yes |
volatile-lru | Evict keys with TTL by LRU | Yes |
volatile-lfu | Evict keys with TTL by LFU | Yes |
allkeys-lfu | Evict any key by LFU | No |
volatile-random | Evict random keys with TTL | Yes |
allkeys-random | Evict any random key | No |
volatile-ttl | Evict keys nearest to expiry | Yes |
services:
- type: keyvalue
name: cache
plan: starter
region: oregon
maxmemoryPolicy: allkeys-lru
ipAllowList: []
ipAllowList is requiredBlueprints must include ipAllowList on Key Value services. Common patterns:
| Value | Meaning |
|---|---|
[] | No external access (internal only—recommended for most apps) |
[{source: "0.0.0.0/0", description: "everywhere"}] | Open external access (use sparingly) |
[{source: "203.0.113.0/24", description: "office"}] | Specific IP ranges |
Use fromService with type: keyvalue and property: connectionString:
envVars:
- key: REDIS_URL
fromService:
name: cache
type: keyvalue
property: connectionString
Available fromService properties for Key Value:
| Property | Value |
|---|---|
connectionString | Full internal URL (redis://red-xxx:6379) |
host | Hostname only |
port | Port only (typically 6379) |
appendfsync everysec. You may lose up to 1 second of writes on interruption.See references/connection-examples.md for client code in Node.js (ioredis, node-redis), Python (redis-py), Ruby (redis-rb, Sidekiq), and Go.
| Mistake | Fix |
|---|---|
Missing ipAllowList in Blueprint | Add ipAllowList: [] for internal-only access |
Using allkeys-lru for job queues | Switch to noeviction—LRU eviction drops queued jobs |
| Connecting with external URL from a Render service | Use the internal URL for lower latency and no auth requirement |
Forgetting type: keyvalue in fromService | type is required; without it the wiring fails |
Using deprecated redis type alias | Prefer keyvalue in new Blueprints (redis still works but is deprecated) |
| Document | Contents |
|---|---|
references/connection-examples.md | Client code for Node.js, Python, Ruby, Go |
references/troubleshooting.md | Auth errors, connection refused, memory full, migration from Redis 6 |
render.yaml schema, fromService patternsREDIS_URL and other connection vars