Bucket and File Commands

Bucket and File Commands

This page documents the main bucket and file commands in akavecli.

Global flags you will commonly use:

  • --account <wallet-name> which wallet to use
  • --node-address <host:port> Akave node RPC address
  • --metadata-encryption enable metadata encryption
  • --encryption-key "<key>" encryption key for file data

Buckets

Create Bucket

Creates a new bucket on the Akave network.

akavecli bucket create <bucket-name> \
  --account <wallet-name> \
  --node-address connect.akave.ai:5500

Delete Bucket

Soft deletes a bucket.

akavecli bucket delete <bucket-name> \
  --account <wallet-name> \
  --node-address connect.akave.ai:5500

View Bucket

Shows details for a specific bucket.

akavecli bucket view <bucket-name> \
  --account <wallet-name> \
  --node-address connect.akave.ai:5500

List Buckets

Lists all buckets associated with the selected account.

akavecli bucket list \
  --account <wallet-name> \
  --node-address connect.akave.ai:5500

Files

ℹ️
The maximum file size for a single akavecli upload is 5 GB. For larger objects, use Multipart Uploads with the Akave O3 API.

List Files in a Bucket

List all the files in specified bucket

akavecli file list <bucket-name> \
  --account <wallet-name> \
  --node-address connect.akave.ai:5500

Get File Info

Fetches metadata about a file.

akavecli file info <bucket-name> <file-name> \
  --account <wallet-name> \
  --node-address connect.akave.ai:5500

Upload File

Uploads a file from your local filesystem into the bucket.

akavecli file upload <bucket-name> <file-path> \
  --account <wallet-name> \
  --node-address connect.akave.ai:5500

You may also add:

  • --metadata-encryption
  • --encryption-key "<key>"

for encrypted data and metadata.

Download File

Downloads a file from a bucket.

akavecli file download <bucket-name> <file-name> <destination-folder> \
  --account <wallet-name> \
  --node-address connect.akave.ai:5500

Delete File

Removes a file from a bucket.

akavecli file delete <bucket-name> <file-name> \
  --account <wallet-name> \
  --node-address connect.akave.ai:5500
Last updated on