Local Disk Cache

An optional local disk read-through cache can be placed in front of S3 for improved read performance.

How It Works

1. Client requests a blob
2. mise-server checks the local disk cache
3. On local miss, fetches from S3 and stores locally
4. Returns the blob to the client
5. LRU eviction keeps the cache within the configured size limit

Configuration

[settings]
s3_local_cache_size = 10737418240  # 10 GiB (0 = disabled)
data_dir = "/data"                  # blobs stored under data_dir/cache/blobs/

export MISE_SERVER_S3_LOCAL_CACHE_SIZE=10737418240
export MISE_SERVER_DATA_DIR=/data

Set s3_local_cache_size to 0 (the default) to disable the local cache and read directly from S3.

Storage Path

Cached blobs are stored at {data_dir}/cache/blobs/{hash[0:2]}/{hash}, matching the content-addressable layout used by S3.