Skip to content
Edka Kubernetes Management Platform Edka Kubernetes Management Platform Edka
SYS.DOCS // DOCS

Registry Overview

Edka includes a managed in-cluster registry based on Zot. It runs inside your cluster and gives you a local image endpoint for builds and deployments.

Where to manage it

  1. Open your cluster.
  2. Go to Settings > Registries.
  3. Open the Cluster Registry tab.

You can manage both:

  • Cluster Registry: in-cluster Zot.
  • External Registries: credentials such as GHCR, Docker Hub, ECR, GAR, or custom registries.

Install the in-cluster registry

Before install, configure:

  • Persistent Volume Size (for example 20Gi).
  • Storage Class (optional, defaults to cluster default).

Then click Install Registry.

When installed, Zot is exposed internally at:

  • zot.registry.svc.cluster.local

Runtime status and usage visibility

The Registry Overview (Zot) panel shows live operational state, including:

  • Endpoint and namespace.
  • Pods ready count.
  • Workload type/name and replicas ready.
  • Pod phases and total container restarts.
  • Repository count and tags.
  • Persistent volume usage and available capacity.
  • Resource requests/limits and runtime CPU/memory usage (when Kubernetes metrics are available).
  • Warnings when metrics/catalog/volume data are temporarily unavailable.

Expand storage for an existing registry

You can expand storage after install:

  1. Enter a larger PVC size than the current requested size.
  2. Click Expand Storage.
  3. Watch the Volume Expansion In Progress status card.

During expansion, Edka shows:

  • Progress state updates.
  • Target size.
  • Current provisioned capacity.

Notes:

  • Shrinking is not supported.
  • Storage class changes are not supported after install.
  • Expansion completion depends on storage backend behavior and can take several minutes.

Uninstall safety guard

Edka blocks uninstall when workloads still depend on the in-cluster Zot registry endpoint.

This prevents breaking deployments or cronjobs that still pull/push images via:

  • zot.registry.svc.cluster.local

If uninstall is blocked, move dependent workloads to another registry first, then retry.

Image usage examples

Terminal window
# Push
docker push zot.registry.svc.cluster.local/my-app:latest


# Pull
docker pull zot.registry.svc.cluster.local/my-app:latest