Harbor is an open-source registry for OCI artifacts — container images, Helm charts published as OCI, and any other conformant artifact type — that wraps the plain distribution registry in the governance layer an organisation actually needs. A bare registry stores and serves blobs. Harbor adds identity, per-project permissions, vulnerability scanning, signature verification, retention and replication on top of that storage, and enforces them at the point of push and pull rather than in a pipeline that can be skipped.
The unit of organisation is the project. A project is public or private, carries members with roles from limited guest through developer and maintainer to project administrator, and holds its own policy: a vulnerability severity threshold that blocks pulls of affected artifacts, a requirement that artifacts be signed before deployment, immutability rules that prevent a tag being overwritten once published, tag retention rules that keep a defined number of recent artifacts per repository, and a storage quota. Robot accounts give CI systems scoped, revocable credentials that are not tied to a person.
Architecturally Harbor is several services: a core API, a jobservice for asynchronous work such as scanning and replication, the upstream distribution registry with its controller, PostgreSQL for metadata, Redis for caching and job state, and a pluggable scanner, usually Trivy. Replication rules move artifacts to and from other registries — Harbor, Docker Hub, ECR, ACR, GCR, Quay, Artifactory — on a push or pull trigger, which is what makes air-gapped mirroring and geo-distribution practical. Proxy cache projects act as a pull-through cache for an upstream registry, which is also the usual answer to rate limits.
Why this skill matters now
Software supply chain attacks moved registry governance from a nice-to-have to an audit requirement. The questions being asked now — which images are running, where did they come from, who signed them, what vulnerabilities do they carry, and can an unsigned artifact reach production — are all registry questions, and a bare distribution registry cannot answer any of them.
There is a simpler operational driver too. Pulling directly from public registries at scale is fragile: rate limits, upstream deletions and network egress all fail at inconvenient moments, and regulated or air-gapped environments cannot do it at all. A private registry with proxy caching and replication rules turns that into a solved problem, and Harbor is the most widely deployed open-source option for it.
What teams actually need to learn is the policy design rather than the installation. Which severity gate is enforceable without stopping every deployment, how retention interacts with immutability, how to structure projects so permissions map to teams, how robot accounts are scoped and rotated, and how replication behaves in an air-gapped topology. Those decisions determine whether the registry is a control or an obstacle.