Docs

CLI: Storage

Create and configure buckets, upload, download, list, move and delete objects, and sign URLs with sov.

Updated Oct 16, 2026

sov storage

Object storage management

sov storage buckets

List all storage buckets.

sov storage buckets [OPTIONS]
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov storage create-bucket

Create a new storage bucket.

sov storage create-bucket [OPTIONS] NAME

Arguments and options

NAMEtextrequired
Bucket name
--publicflagoptional
Make bucket public
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov storage ls

List objects in a bucket.

sov storage ls [OPTIONS] BUCKET

Arguments and options

BUCKETtextrequired
Bucket name
--prefixtextoptional
Filter by prefix
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov storage upload

Upload a file to a bucket.

sov storage upload [OPTIONS] BUCKET FILE_PATH

Arguments and options

BUCKETtextrequired
Bucket name
FILE_PATHtextrequired
Local file path
--nametextoptional
Remote object path (defaults to filename)
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov storage download

Download an object to a local file.

sov storage download [OPTIONS] BUCKET OBJECT_PATH

Arguments and options

BUCKETtextrequired
Bucket name
OBJECT_PATHtextrequired
Remote object path
--output / -opathrequired
Local output file path
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov storage sign-download

Mint a time-limited signed download URL.

sov storage sign-download [OPTIONS] BUCKET OBJECT_PATH

Arguments and options

BUCKETtextrequired
OBJECT_PATHtextrequired
--expires-inintegeroptionaldefault 3600
TTL seconds
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov storage sign-upload

Mint a time-limited signed upload URL.

sov storage sign-upload [OPTIONS] BUCKET OBJECT_PATH

Arguments and options

BUCKETtextrequired
OBJECT_PATHtextrequired
--expires-inintegeroptionaldefault 3600
TTL seconds
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov storage rm

Delete an object from a bucket.

sov storage rm [OPTIONS] BUCKET OBJECT_PATH

Arguments and options

BUCKETtextrequired
Bucket name
OBJECT_PATHtextrequired
Object path to delete
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov storage bucket-get

Fetch bucket metadata.

sov storage bucket-get [OPTIONS] NAME

Arguments and options

NAMEtextrequired
Bucket name
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov storage bucket-update

Update bucket settings.

sov storage bucket-update [OPTIONS] NAME

Arguments and options

NAMEtextrequired
Bucket name
--public / --privateflagoptional
--file-size-limitintegeroptional
--allowed-mime-typestextoptional
Comma-separated MIME patterns
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov storage bucket-delete

Delete a storage bucket and all objects.

sov storage bucket-delete [OPTIONS] NAME

Arguments and options

NAMEtextrequired
Bucket name
--yes / -yflagoptional
Skip confirmation
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov storage move

Move or rename an object within storage.

sov storage move [OPTIONS]

Arguments and options

--fromtextrequired
Source path bucket/object
--totextrequired
Destination path bucket/object
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.
Something unclear or missing on this page?Tell us