Create a Bucket
This guide explains how to create a new Object Storage bucket in CloudRaya using StorageRaya, CloudRaya’s S3-compatible object storage service.
Buckets are the top-level containers used to store objects such as files, images, backups, logs, and application assets.
Before You Begin
Make sure you understand the following:
- Buckets are region-specific
- Bucket names must be globally unique
- Settings such as file listing and bucket limit affect how objects can be accessed and stored
📄 See: StorageRaya Overview
Accessing StorageRaya
To create a bucket:
- From the CloudRaya Control Panel home page, select your active Project
- Navigate to Storage → StorageRaya
- You will see the StorageRaya bucket list page
If you do not have any buckets yet, the page will display an empty state.
Create a New Bucket
Step 1: Click Add Bucket
From the StorageRaya page, click + Add Bucket.
An Add Bucket dialog will appear.
Step 2: Configure Bucket Settings
Fill in the following fields:
Bucket Name
Enter a globally unique bucket name.
Requirements:
- Must be unique
- Length between 3 and 63 characters
- Must start with a lowercase letter or number
- Can contain:
- Lowercase letters
- Numbers
- Hyphens (-)
- No uppercase letters or spaces
Example:
cr-storageraya-assetsServer Location
Select the Server Location (region) where the bucket will be created.
Notes:
- Buckets are tied to a single location
- Data does not automatically replicate across regions
- Choose the location closest to your workloads for best performance
File Listing
Choose how objects inside the bucket can be listed:
- Restrict File Listing (Recommended)
- Prevents public directory listing
- Improves security
- Enable File Listing
- Allows public listing of objects when accessed
Best practice:
Use Restrict File Listing unless public browsing is required.
Bucket Limit
Set a maximum storage size for the bucket.
- Enter a value in GB
- The minimum allowed value is 1 GB
- This value is drawn from your account's shared bucket storage pool. See Storage FAQs for the current pool size and how it is shared across buckets.
Bucket limits help control storage usage and cost.
Add Expiration Date (Optional)
Enable this option if the bucket should expire automatically.
- Select an expiration date
- The timezone shown matches your panel's configured timezone (for example, Asia/Jakarta, GMT+7)
When the expiration date is reached:
- The bucket is deleted automatically, along with its contents
- Useful for temporary projects or time-bound storage
Step 3: Save the Bucket
After reviewing all settings:
- Click Save
- The system processes the request
- The bucket appears in the StorageRaya list once created
After the Bucket Is Created
Once the bucket is created, CloudRaya displays a credentials confirmation dialog.
This dialog contains the access information required to connect applications or tools to StorageRaya.
Credentials Popup (Important)
The popup shows:
- Bucket Name
- Access Key
- Secret Key
The Secret Key is shown only once.
CloudRaya does not store or display it again after this dialog is closed.
What You Must Do Immediately
Before closing the dialog:
- Click Copy All or copy the credentials manually
- Store them securely (password manager, secrets vault, or encrypted storage)
- Treat the Secret Key like a password
If the Secret Key is lost, you must reset the access key, which may disrupt applications already using it.
What You Can Do Next
With the bucket created and credentials secured, you can:
- Upload and manage objects
- Configure application access using Access Key and Secret Key
- Integrate StorageRaya with:
- Virtual Machines
- KubeRaya (Kubernetes workloads)
- CI/CD pipelines
- External tools (S3-compatible clients)
- Apply access controls and cost optimization settings
Common Configuration Tips
- Use separate buckets for different applications or environments
- Set bucket limits intentionally to prevent unexpected storage growth
- Avoid enabling file listing unless necessary
Next Step
Secure and configure access credentials before connecting any applications.