Redis

Usage

Driver name: redis

To use it, you will need to install ioredis in your project:

npm i ioredis

Usage with single Redis instance:

import { createStorage } from "unstorage";
import redisDriver from "unstorage/drivers/redis";

const storage = createStorage({
  driver: redisDriver({
    base: "unstorage",
    host: 'HOSTNAME',
    tls: true as any,
    port: 6380,
    password: 'REDIS_PASSWORD'
  }),
});

Usage with a Redis cluster (e.g. AWS ElastiCache or Azure Redis Cache):

⚠️ If you connect to a cluster, you have to use hashtags as the prefix to avoid the Redis error CROSSSLOT Keys in request don't hash to the same slot. This means the prefix has to be surrounded by curly braces, which forces the keys into the same hash slot. You can read more here.

const storage = createStorage({
  driver: redisDriver({
    base: "{unstorage}",
    cluster: [
      {
        port: 6380,
        host: "HOSTNAME",
      },
    ],
    clusterOptions: {
      redisOptions: {
        tls: { servername: "HOSTNAME" },
        password: "REDIS_PASSWORD",
      },
    },
  }),
});

Options:

• base: Optional prefix to use for all keys. Can be used for namespacing. Has to be used as a hashtag prefix for redis cluster mode.
• url: Url to use for connecting to redis. Takes precedence over host option. Has the format redis://<REDIS_USER>:<REDIS_PASSWORD>@<REDIS_HOST>:<REDIS_PORT>
• cluster: List of redis nodes to use for cluster mode. Takes precedence over url and host options.
• clusterOptions: Options to use for cluster mode.
• ttl: Default TTL for all items in seconds.
• scanCount: How many keys to scan at once (redis documentation).
• preConnect: Whether to initialize the redis instance immediately. Otherwise, it will be initialized on the first read/write call. Default: false.

See ioredis for all available options.

Transaction options:

• ttl: Supported for setItem(key, value, { ttl: number /* seconds */ })