Create a Registry

This guide explains how to create a Container Registry using the CloudRaya Control Panel.

A registry is a private image repository used to store and distribute container images for Kubernetes (KubeRaya), CI/CD pipelines, and VM-based container workloads.

Before You Begin

Make sure you have:

• An active CloudRaya account
• Access to the CloudRaya Control Panel
• A project selected

Step 1: Open the Container Registry Menu

1. From the CloudRaya Control Panel home page, select your active Project
2. Navigate to Storage → CloudRaya Container Registry

You will see a list of all registries in the selected project.

Step 2: View Existing Registries

On the Container Registry page, you can:

• View all existing registries
• Copy registry endpoint URLs
• Open registry details
• Create a new registry

If no registry exists yet, the list will appear empty.

Step 3: Create a New Registry

Click + Add Registry to open the creation dialog.

Step 4: Configure Registry Settings

Registry Name

• Used as the registry identifier
• Appears in registry endpoint URLs
• Must be unique within the project

Example:

my-registry

Registry Credentials (Password)

This password is used to authenticate container clients such as Docker, containerd, and Podman.

Password requirements:

• Minimum 8 characters
• Must include:
  • At least 1 lowercase letter
  • At least 1 uppercase letter
  • At least 1 numeric character

You must confirm the password before continuing.

Storage Size

• Defines the maximum storage capacity for the registry
• Can be adjusted later as your image library grows

Free Storage Benefit

Each CloudRaya account includes:

This free quota is applied once per account, not per registry. If you create more than one registry, only one registry's cost is offset by the free quota, the rest are billed in full.

Step 5: Review Pricing

Before creating the registry, CloudRaya displays:

• Hourly cost
• Allocated storage size
• Free quota usage

This allows you to review cost impact before confirming.

Step 6: Create the Registry

Click Save to create the registry.

Once completed:

• The registry appears in the registry list
• A registry endpoint URL is generated
• The registry is ready to accept container images

After the Registry Is Created

You can now:

• Authenticate using Docker or other container tools
• Push and pull container images
• Integrate the registry with KubeRaya (CloudRaya Kubernetes)
• Adjust storage capacity
• Rotate registry credentials if needed

Important Notes

• The Container Registry is private by default
• Access requires explicit authentication
• Registry credentials are separate from your CloudRaya account login

Related Guides

📄 Access & Authentication

📄 Push & Pull Images

📄 Integrate with Kubernetes (KubeRaya)

📄 Manage Registry

📄 Container Registry Best Practices