autumn-cache-redis

Redis-backed shared cache plugin for autumn-web applications.

This crate provides a RedisCache implementation that stores cached values in Redis, suitable for multi-process or multi-instance Autumn deployments that need a shared, externally-accessible cache instead of the default in-process Moka store.

Installation

autumn plugin add autumn-cache-redis

One command adds the dependency at a version compatible with your app's autumn-web, mounts the plugin in your autumn_web::app() builder chain, and prints any configuration still needed. It is safe to re-run, and it refuses — before touching any file — to install into an app on an incompatible autumn-web version. See docs/plugins.md.

Manual install

If you would rather wire it yourself (or autumn plugin add could not find your builder chain and printed these lines for you):

[dependencies]
autumn-web        = { version = "0.8", features = ["redis"] }
autumn-cache-redis = "0.8"

Quick Start

autumn plugin add autumn-cache-redis writes this mount for you. It reads [cache] at startup and installs the Redis cache only when backend = "redis", so it is inert until you configure it:

use autumn_cache_redis::RedisCachePlugin;

#[autumn_web::main]
async fn main() {
    autumn_web::app()
        .plugin(RedisCachePlugin::new())
        .run()
        .await;
}

To build the store yourself instead — bypassing the [cache] backend switch — construct it and install it on the builder:

use autumn_cache_redis::RedisCache;

#[autumn_web::main]
async fn main() {
    let cache = RedisCache::from_config(&config.cache.redis)
        .await
        .expect("Redis connection established");

    autumn_web::app()
        .with_cache_backend(cache)
        .run()
        .await;
}

Configuration

Select the Redis backend and point it at your server in autumn.toml:

[cache]
backend = "redis"

[cache.redis]
url = "redis://127.0.0.1:6379"

RedisCachePlugin reads [cache] at startup: until backend = "redis" is set it is a no-op and the default in-process Moka cache stays in use.

The URL follows the standard Redis URL format and is passed directly to the redis crate's connection manager.

Status