Disks, not paths.

Put and get files on named disks — local, memory, or S3 and the services that speak it, like Cloudflare R2 and MinIO.

Read the File storage docs

Terminal output of Storage calls on the local disk: put, exists, size, get, list, url, temporary_url and delete.

What you get

A default disk through the Storage facade, named disks through Storage::disk.
Disks declared once at boot; the call site does not know which backend it has.
A memory disk for tests.

In the docs

File storage

src/app/http/controllers/avatar_controller.rs

use rainier_framework::facades::Storage;

// The default disk: local, memory or S3 — and anything that speaks S3.
Storage::instance().put("avatars/7.png", bytes).await?;
let avatar = Storage::instance().get("avatars/7.png").await?;

// A named one, declared once at boot.
Storage::disk("archive").unwrap().put("2026/report.pdf", bytes).await?;

Up close

Select an image to see it full size.

Storage get("../../etc/passwd") returning Err(BadRequest): a storage path must not contain "..". — A path that tries to climb out of the disk is refused rather than resolved.

Storage url() returning None and temporary_url() returning a 501 error on the local disk. — A disk that cannot sign a URL says so: temporary_url on the local disk is an error, never a public link passed off as an expiring one.

All features