Overview
A bucket is a container that groups objects in DreamObjects, similar to a folder. Unlike a folder, buckets exist in a single global namespace inside DreamObjects, so every bucket name must be unique — like a domain name — because bucket names are used to build the public URLs that store and serve objects.
How do I create a bucket?
- Navigate to the DreamObjects page in your DreamHost panel.
- Click the Manage tab at the top.
- Under your username, click the Add Bucket button.
- Enter a bucket name in the Bucket Name field.
- Click the Add Bucket button.
Bucket names have specific requirements. See the DreamObjects Bucket Names article for details.
How do I set bucket permissions?
You can set a bucket to public or private permissions. See the DreamObjects permissions article for details. To choose a permission setting, edit the bucket:
- Navigate to the DreamObjects page in your DreamHost panel.
- Click the Change Settings link to the right of your bucket.
- Click the 'Permissions' toggle to select a permission setting for the bucket's contents.
- Choose either Private or Public.
- You can change the permission setting at any time after creating the bucket.
More information about setting permissions
A public bucket lets anyone view the bucket's properties and a list of its contents by navigating to the bucket URL.
Buckets on the DreamObjects US-East 5 cluster
All objects within a bucket inherit the permission level set for the bucket that contains them. Objects within a public bucket have all of their individual permissions set to public as well. New buckets default to private permissions.
How do I edit a bucket?
Editing options for a bucket are limited. You can:
- Modify the permission settings on an existing bucket at any time.
- Add or remove contents from a bucket.
How do I delete a bucket?
You cannot delete a bucket that contains any objects. Bucket deletion is also non-reversible. MAKE SURE you have backed up all data in the bucket before deleting it.
- You can use a DreamObjects client to delete all bucket contents (recommended), or
- You can use this AWS CLI command to delete all bucket contents via SSH (advanced).
- Navigate to the DreamObjects page in your DreamHost panel.
- Click the Manage tab.
- Click your username. The page expands and displays your key pairs and buckets.
- To the right of your bucket, click the Remove Bucket button.
- Click the Remove button to delete the bucket.
How do I access objects in a bucket?
For instructions on accessing objects within a bucket, see the following article: