Storage

Upload, list, and manage static files on the Cluster edge CDN.

Storage

Cluster's object storage lets you keep static files (images, CSS, PDFs, etc.) on the edge CDN and serve them alongside your functions. Files live inside a store — a named bucket tied to your organization. You can have multiple stores per organization.

The command is available as ccp store (primary) or ccp storage (alias) — use whichever you prefer.

Create a Store

ccp storage create my-assets
# ✓ Created store "my-assets"

A store needs to exist before you can upload files to it. When you run any storage command, CCP will use the store_id from your project's .cluster/config.json if present, or prompt you to select one.

Upload Files

ccp storage put logo.png styles.css
# ◼ Uploaded logo.png
#   https://assets.cluster.app/edge/serve/...
#
# ◼ Uploaded styles.css
#   https://assets.cluster.app/edge/serve/...

Multiple files upload in parallel. upload is an alias for put if you prefer.

Download a File

ccp storage get logo.png
# ✓ Downloaded logo.png

Use -o / --output to save to a specific path:

ccp storage get logo.png --output ./assets/logo.png

List Files

ccp storage ls
# • logo.png    12.4 KB
#   https://assets.cluster.app/edge/serve/...
#
# • styles.css  3.2 KB
#   https://assets.cluster.app/edge/serve/...

list is an alias for ls.

Remove Files

ccp storage rm logo.png
# ✓ Removed logo.png

remove is an alias for rm.

Subcommand Reference

SubcommandAliasesDescription
create <name>Create a new store
put <files...>uploadUpload one or more files
get <filename>Download a file (optional -o / --output)
lslistList files in the store
rm <filename>removeDelete a file

Function Context

Storage commands need to know which store to operate on. CCP resolves this automatically if your project's .cluster/config.json has a store_id. Otherwise, it prompts you to select an organization and store interactively.

On this page