Skip to main content
Swytch Documentation
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Durability and Tiering

Start with memory when the application can refill its cache. Add local durability to restore resident state after a restart, or a storage tier when retention needs to extend beyond the local working set or disk.

Storage choiceWhat it gives youBoundary
Memory-only SwytchFast, disposable local state; shared keys may have other holdersLosing every holder loses the data
Local durabilityOpen-source disk mirror enabled with --data-dirAsynchronous sync; eviction removes records; recovery needs sufficient memory and the same storage
AtmosA commercial local-disk tierAvailable to commercial customers; setup documentation is supplied separately
Swytch CloudA network storage tier and peer discoveryOnly uploaded, acknowledged state has reached durable storage

Atmos documentation is supplied separately to commercial customers.

Choose by the failure you need to survive

A process restart, Pod replacement, and loss of a node are different failures. Memory disappears with the process. Local storage depends on the lifetime and availability of its disk. A network tier can recover acknowledged state after all local processes stop. Local durability mirrors resident effects; it does not keep evicted keys available as a disk tier.

For local recovery, the memory-pressure fallback is part of the operating contract: if recovery cannot fit, Swytch waits 30 seconds before deleting the mirror and continuing empty.

Adding another Swytch replica does not automatically make a backup of every key. Subscriptions follow use.

Enable local durability, configure Swytch Cloud, or follow Kubernetes tiering. For a rollout plan, read survive pod replacement.