Skip to content

Private container registry quickstart

Ravenstash Container repositories accept standard OCI container images and Docker Registry HTTP API V2 schema-2 images. They support tags, immutable digest references, multi-platform indexes, and OCI 1.1 referrers.

  • Authenticated pushes and pulls with Docker and OCI-compatible clients.
  • OCI image manifests and indexes, including multi-platform images.
  • Docker schema-2 image manifests and manifest lists.
  • Resumable blob uploads and deduplicated digest-addressed storage.
  • Mutable tags, immutable manifest digests, and OCI referrer discovery.
  • Browser views for OCI repositories, tags, manifests, platforms, blobs, and attachments.

Legacy Docker schema 1 images are not supported.

  1. Create a repository with Container enabled, or add Container to an existing repository.
  2. Install Docker or another supported OCI client and sign in to rvs.
  3. Select your repository with rvs art select platform/runtime-images.
  4. Build locally and push an image with rvs docker push acme/api:1.0.0.
  5. Pull it by tag or immutable digest and inspect its graph in Ravenstash.

Docker push, pull, and tag expand short image paths inside the selected repository. Dockerfiles and Buildx output tags still need a full reference. The examples use this readable root:

oci.rvsta.sh/platform/runtime-images

rvs refreshes this root when a namespace or repository is renamed. The image name follows it:

oci.rvsta.sh/platform/runtime-images/acme/api:1.0.0

A tag such as latest, prod, or 1.0.0 is a mutable selector. A manifest digest such as sha256:... is the immutable revision identity.

OCI attachments such as signatures, attestations, SBOMs, and provenance can be stored and discovered as referrers.