Skip to main content

Overview

Manages files in the configured storage adapter (local filesystem, S3, R2, GCS, etc.). The adapter is transparent — these commands work identically regardless of which storage backend is configured.

Commands

applad storage list

Lists all storage buckets defined in the active project’s storage/ directory, along with their visibility (public or private), size limits, and allowed file types.
applad storage list

applad storage ls

Lists all files in a specific bucket. Shows filename, size, content type, upload date, and owner.
applad storage ls <bucket>
Example:
applad storage ls avatars

applad storage upload

Uploads a local file to a bucket. Applies the bucket’s configured virus scan, file type validation, and size limit before accepting the file.
applad storage upload <bucket> <file>
Example:
applad storage upload avatars ./profile.jpg

applad storage download

Downloads a file from a bucket to the current local directory. Works with both public and private buckets — for private buckets, your SSH key identity is used to authorize the download.
applad storage download <bucket> <file>
Example:
applad storage download documents invoice-2026-02.pdf

applad storage delete

Permanently deletes a file from a bucket. Cannot be undone.
applad storage delete <bucket> <file>
Example:
applad storage delete temp temp-file.zip

applad storage move

Moves or renames a file within or between buckets. The source file is removed after the copy is confirmed.
applad storage move <bucket> <file> <destination>
Example:
applad storage move drafts document.pdf published/document.pdf

applad storage scan

Runs a virus scan on all files currently stored in a bucket. Reports any threats found. By default Applad scans files at upload time — use this to scan existing files retrospectively or to audit a bucket’s contents.
applad storage scan <bucket>
Example:
applad storage scan uploads

Build docs developers (and LLMs) love