Documentation
Container Registry
Getting Started

Getting Started with Container Registry

This guide walks you through creating your first container registry namespace and pushing your first image.

Prerequisites

  • A Thalassa Cloud account with appropriate permissions
  • Docker or Podman installed on your local machine
  • A container image to push (or create a simple test image)

Step 1: Create a Namespace

Access Container Registry

  1. Log into the Thalassa Cloud Console
  2. Navigate to Platform → Container Registry
  3. Click Create Namespace

Configure Namespace

Enter namespace details:

  • Name: Choose a descriptive name (e.g., my-team, production, backend-apps)
  • Description: Optional description of the namespace purpose

Click Create to create the namespace.

Step 2: Authenticate

Get Access Credentials

  1. Navigate to API Access (top right)
  2. Go to Access Credentials
  3. Select the organisation for which you want to create the access credentials
  4. Select the Container Registry scopes (push / pull)

Service Accounts Access

You can also use a service account with access credentials, which is recommended for production use-cases and integration with for example Kubernetes Clusters. Alternatively, you can use the Service Account with OIDC and workload federation (Advanced).

Log In

Log in to the registry using Docker:

docker login registry.nl-01.thalassa.cloud

Enter your access key for the username, and access secret as password when prompted.

The registry hostname follows the pattern registry.<region>.thalassa.cloud. Use the endpoint for your region.

Step 3: Push Your First Image

Tag Your Image

Tag your image with the registry hostname and namespace:

docker tag myapp:1.0 registry.nl-01.thalassa.cloud/<namespace>/myapp:1.0

Replace:

  • <namespace> with your namespace name
  • myapp:1.0 with your image name and tag

Push the Image

Push the image to the registry:

docker push registry.nl-01.thalassa.cloud/<namespace>/myapp:1.0

Verify

Verify the image was pushed successfully:

  1. Check the console for your image
  2. Or list repositories using the API

Pull and Use Images

Pull the image:

docker pull registry.nl-01.thalassa.cloud/<namespace>/myapp:1.0

After pulling your image from Thalassa Container Registry, you can use it in your Kubernetes deployments or with other container orchestration platforms. To deploy in Kubernetes, update your Pod or Deployment manifests to reference the image using the full registry path (for example, registry.nl-01.thalassa.cloud/<namespace>/myapp:1.0).

Ensure that any compute nodes or platforms are able to authenticate to your registry as needed. These images can also be used seamlessly with tools like Docker Compose, Nomad, or any other OCI-compliant container service by specifying the image path where required.

Retention Policies