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 CDN affect how objects can be accessed

📄 See: StorageRaya Overview

Accessing StorageRaya

To create a bucket:

1. From the CloudRaya Control Panel home page, select your active Project
2. Navigate to Storage → StorageRaya
3. 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 New Bucket

From the StorageRaya page, click + Add New Bucket.

A Create New 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-assets

Server Location

Select the Cloud Zone 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.

CDN

Enable or disable CDN support for this bucket:

• Disable
  • Objects are served directly from StorageRaya
• Enable
  • Objects are delivered through CDN for improved global performance

Common use cases for enabling CDN:

• Static websites
• Images and media files
• Public application assets

Bucket Quota

Set a maximum storage size for the bucket.

• Enter a value in GB
• Enter 0 for unlimited

Quotas help control storage usage and cost.

Add Expiration Date (Optional)

Enable this option if the bucket should expire automatically.

• Select an expiration date
• Timezone is UTC (GMT+0)

When the expiration date is reached:

• The bucket and its contents may be removed
• Useful for temporary projects or time-bound storage

Step 3: Save the Bucket

After reviewing all settings:

1. Click Save
2. The system processes the request
3. 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

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
• Enable CDN only when public access is required
• Set quotas to prevent unexpected storage growth
• Avoid enabling file listing unless necessary

Next Step

Secure and configure access credentials before connecting any applications.

📄 Access & Credentials

Related Pages

📄 StorageRaya Overview

📄 Manage Buckets & Objects

📄 Use Cases & Best Practices

📄 Storage Services Overview