Storage & volumes

BitsReef gives you two kinds of storage: volumes for persistent filesystem data attached to a service, and storage buckets for S3-compatible object storage.

Volumes

A volume is persistent disk mounted into a service’s container — data survives redeploys and restarts. Volumes are scoped to a project.

1. On the project canvas, click Add Volume in the bottom toolbar.
2. Give it a name, a size limit (MB), and the mount path inside the container (e.g. /data).
3. Optionally attach it to a service, then create.

Caution

Deleting a volume destroys its data.

Storage buckets

Buckets provide S3-compatible object storage for files your app reads and writes at runtime — uploads, exports, backups.

1. Open Storage from the top nav and create a bucket.
2. Open the bucket to browse objects, upload files, and manage folders directly in the dashboard.
3. For programmatic access, use the bucket’s credentials and endpoint with any S3-compatible client (AWS SDK, aws s3, mc, …).

Volumes vs. buckets

Use a volume when your app expects a local filesystem path. Use a bucket when you want object storage addressable over an S3 API — especially for content shared across replicas or accessed from outside the container.

From the CLI

Volumes are scriptable from the CLI (buckets are managed in the dashboard):

bitsreef volumes create data --size 512 --mount /data --service web
bitsreef volumes list
bitsreef volumes delete data

See also

• Core concepts