Skip to Content
We are live but in Staging 🎉
Overview

Dodil Registry

Dodil Registry is the platform’s container registry. Push and pull OCI images with the tools you already use — docker, podman, oras — browse repositories in the console, and read a vulnerability report for every image you push.

docker push registry.dodil.io/<org>/<repo>:<tag>  →  stored + CVE-scanned  →  pull / deploy

Two planes, both plain HTTP

Registry is HTTP-first. Where other Dodil products expose many wire adapters, Registry exposes exactly two surfaces, on the same host:

  • The Docker Registry v2 API (/v2/...) — the standard image wire protocol. Any OCI-compliant client works as-is; there is no Dodil SDK to install. See Docker Registry v2 API.
  • A REST control plane (/<org>/...) — everything around the images: repository listing, artifacts and their tags, vulnerability reports, and visibility. See Control Plane API.

There is no “create repository” call on either plane — a repository is created implicitly by the first push to its name.

Why Dodil Registry

  • Vulnerability scanning at push. Every pushed image is scanned for CVEs; the report (severity, totals, fixable count, per-CVE detail) is readable from the console, the CLI, and the API.
  • Public and private repositories. Repositories are private by default; flipping one public allows anonymous pulls.
  • Org-scoped access. Repositories live under your organization (<host>/<org>/<repo>), authorized through Dodil IAM roles and dk_ API keys.
  • Immutable tags. Tags can be marked immutable so a released reference can’t be silently repointed.

How it fits with Dodil

  • Deploy on Ignite . A pushed image deploys directly as an Ignite app via --image-ref — see the recipe.
  • Auth via Dodil IAM. docker login uses a dk_ API key issued by dodil auth apikey issue as the password — no separate registry credentials to manage.

In this section

  • Quickstart — API key → docker login → push → pull, in five minutes
  • Core Concepts — repositories, artifacts, tags, digests, visibility, scanning, the two-plane model
  • CLI Guide — the dodil registry commands
  • API Reference — the control plane endpoints and the Docker v2 surface
  • Recipes — CI pushes and deploying to Ignite

CLI: dodil registry — see Install the CLI .

Quickstart