Provision a Valkey Cache in Your AWS Account

Springwinter provisions a Valkey cache directly in your AWS account using AWS ElastiCache. Valkey is an open-source, Redis-compatible key-value store, so any Redis client library works without modification. Your web servers and workers connect to it over TLS from within the same project’s network — no public exposure, no password required.

What Is Valkey?

Valkey is an open-source, community-maintained fork of Redis, licensed under BSD. It is wire-compatible with Redis clients and supports the same data structures: strings, hashes, lists, sets, sorted sets, and more. Springwinter provisions Valkey through AWS ElastiCache, so you get managed patching, automated failover, and CloudWatch metrics without running the infrastructure yourself.

Create a Cache

Open your project

Navigate to your project in the Springwinter dashboard and click Add resource.

Select Cache

Choose Cache from the resource type list. You will be taken to the cache configuration form.

Choose a storage limit

Select the maximum memory allocation for the cache. Springwinter maps your selection to an appropriately sized ElastiCache node.

Create

Click Create. Springwinter provisions the ElastiCache cluster in your AWS account. The cache status changes to Available once provisioning is complete, typically within a few minutes.

Connecting to the Cache

Once the cache is available, the connection endpoint appears in the Connection tab of the cache resource in your dashboard. The connection uses TLS on port 6379. No password is required — access is controlled at the network level, and only resources within the same project can reach the endpoint. Use the connection string as an environment variable so your application code stays portable:

REDIS_URL=rediss://<cache-endpoint>:6379

The rediss:// scheme (double s) tells your Redis client to connect over TLS. No username or password is needed in the URL.

Node.js (ioredis)
Python (redis-py)
Go (go-redis)

import Redis from "ioredis";

const client = new Redis(process.env.REDIS_URL);

await client.set("hello", "world");
const value = await client.get("hello");
console.log(value); // "world"

import os
import redis

client = redis.from_url(os.environ["REDIS_URL"])

client.set("hello", "world")
value = client.get("hello")
print(value)  # b"world"

import (
    "context"
    "fmt"
    "os"

    "github.com/redis/go-redis/v9"
)

opt, _ := redis.ParseURL(os.Getenv("REDIS_URL"))
client := redis.NewClient(opt)

ctx := context.Background()
client.Set(ctx, "hello", "world", 0)
val, _ := client.Get(ctx, "hello").Result()
fmt.Println(val) // "world"

The cache is private to your AWS account’s network. It is not reachable from the public internet — only resources within the same project can connect.

API Reference

Create a Cache

POST /api/projects/{project_id}/redis
Authorization: Bearer <token>
Content-Type: application/json

{
  "name": "my-cache",
  "storage_limit": "1gb"
}

Get a Cache

GET /api/projects/{project_id}/redis/{id}
Authorization: Bearer <token>

Update the Storage Limit

Change the memory allocation of an existing cache by sending a PATCH request:

PATCH /api/projects/{project_id}/redis/{id}
Authorization: Bearer <token>
Content-Type: application/json

{
  "storage_limit": "4gb"
}

Springwinter updates the ElastiCache node type. Expect a brief interruption while the node scales.

Metrics

CloudWatch metrics for your cache — including memory usage, connection count, and cache hit rate — are available from the Metrics tab in the dashboard or via the API:

GET /api/projects/{project_id}/redis/{id}/metrics
Authorization: Bearer <token>

Cost Estimate

Retrieve the current ElastiCache cost estimate and monthly run rate:

GET /api/projects/{project_id}/redis/{id}/cost
Authorization: Bearer <token>

Delete a Cache

To remove the ElastiCache cluster from your AWS account:

DELETE /api/projects/{project_id}/redis/{id}
Authorization: Bearer <token>

Deleting a cache is permanent. All data stored in the cache is lost immediately. Update any environment variables that reference the cache endpoint before deleting, to avoid errors in your running services.

Get Started

Core Concepts

Deploy

Observability

Account & Team

Provision a Valkey Cache in Your AWS Account

What Is Valkey?

Create a Cache

Connecting to the Cache

API Reference

Create a Cache

Get a Cache

Update the Storage Limit

Metrics

Cost Estimate

Delete a Cache

​What Is Valkey?

​Create a Cache

​Connecting to the Cache

​API Reference

​Create a Cache

​Get a Cache

​Update the Storage Limit

​Metrics

​Cost Estimate

​Delete a Cache

What Is Valkey?

Create a Cache

Connecting to the Cache

API Reference

Create a Cache

Get a Cache

Update the Storage Limit

Metrics

Cost Estimate

Delete a Cache