Skip to main content
Pull objects from object storage into a local folder. Talos reads the provider profile saved by credentials:create, lists the remote prefix, and writes matching objects under --destination.

Usage

Examples

Pull a Cloudflare R2 prefix into a local folder:
Pull from Amazon S3:
Unpack downloaded zip archives:
Suppress progress and summary output:

Options

Providers

Download behavior

Talos lists objects under the remote prefix. If the listing is empty, it treats --from as one exact object key and tries to download that object. Each object keeps the path it has under the prefix. If the key exactly equals the prefix, Talos keeps only the key’s file name. Keys ending in / are ignored.

Safety

Remote keys are treated as untrusted. Talos refuses keys whose local path would escape the destination folder. When --unzip is set, zip entries that would escape the archive output folder are dropped.

Unzipping

With --unzip, only downloaded keys ending in .zip are unpacked. The archive unpacks into a folder named after the archive without the .zip extension; for example, dist.zip unpacks into dist.

Output

Without --silent, Talos shows a loader while downloads run. On success it prints Pulled N object(s) into <destination>. If any object fails, it prints each failed key and message, prints a pulled/failed summary, and exits with code 1.