Skip to content
AlmasixAlmasix

File Storage

Storage

Section titled “Storage”
from almasix.filesystem import Storage, storage


Storage.put("avatars/ada.png", contents)
Storage.disk("public").put("logo.svg", svg, visibility="public")
storage("local").get("avatars/ada.png")
Storage.url("avatars/ada.png")
Storage.exists("avatars/ada.png")

Config lives in config/filesystems.py. Default disks: local, public, s3 (optional almasix[s3] / boto3), plus memory for tests.

Public disk

Section titled “Public disk”
Terminal window
python smith storage:link

Creates public/storage → storage/app/public (configurable via filesystems.links).

temporary_url() is supported on S3-compatible disks (presigned). Local and memory disks raise RuntimeError — generate your own signed URLs if needed.

Uploads

Section titled “Uploads”
await Storage.disk("public").put_file_async("uploads", request.file("avatar"))
Section titled “Related”
  • Cache — file cache under storage/framework/cache
  • Mail — attachments from Storage disks
  • Queues — job artifacts