Buckets
S3-compatible object storage — upload files, manage credentials, and turn on public read.
A bucket is S3-compatible object storage attached to an environment. Use it for user uploads, exports, generated assets, or anything else you do not want on a container's disk.
Buckets are billed on the amount of data stored, not on a fixed size.
Creating a bucket
- Click + Add and choose Bucket.
- Enter a name.
- Click Apply in the Apply Changes bar.
Credentials
Open the service panel → Settings tab. You get:
| Field | Use |
|---|---|
| Endpoint URL | The S3 endpoint your client connects to |
| Region | The region string your client expects |
| Bucket name | The bucket to address |
| Access Key ID | The access key |
| Secret Access Key | The secret key |
The secret is hidden by default. Click Reveal to show it.
Any S3 client works — the AWS SDKs, aws s3 with --endpoint-url, rclone, mc. Point it at the endpoint URL above rather than at Amazon's.
Regenerating credentials
Click Regenerate credentials to issue a new key pair. The old pair stops working immediately, so update anything using it first.
Browsing objects
The Objects tab lists what is in the bucket, with size and last-modified time. From here you can:
- Upload files
- Create a folder
- Download an object
- Delete an object, or delete everything under a prefix
Storage used shows the total, along with when it was last measured. It is sampled periodically, so a large upload can take a few minutes to show up.
Public read
By default a bucket is private — every request must be signed with the credentials above.
Turn on Public Access in the Settings tab to let anyone read objects without credentials. A public URL appears once it is on.
Public read applies to the whole bucket, not to individual objects. Do not turn it on for a bucket holding user data. If you only want to serve a website, use a static site instead.
Writes always require credentials, whether public read is on or not.
Deleting a bucket
Open the service panel → Settings tab → Delete Bucket, then apply the change.
Deleting a bucket deletes every object in it. This cannot be undone.
