# Container Registry

> A server that stores container images. You push them up and pull them down.

**Field:** Infrastructure  
**Category:** Containers  
**Also known as:** Image Registry, Docker Registry, Container Image Registry

## Think of it like

It is like a library for images. You put one on the shelf, and others can borrow it.

## Definition

A container registry is a server that stores container images. You push an image up after you build it. Servers pull it down when they need to run it. Images are kept in named folders called repositories, with a tag for each version. A registry can be public for anyone, or private for one team.

## Example

Lucy's build pipeline pushes each new image to her team's private registry. The live servers pull version 2.3 from there and start it.

## Example code

```bash
docker tag shop-app:2.3 registry.example.com/team/shop-app:2.3
docker push registry.example.com/team/shop-app:2.3
```

The new name says which registry and folder the image goes to. Push sends it there.

## Why it matters

Servers need one trusted place to fetch images from. The registry is that place.

## Common mistake

Always pulling the latest tag. It can point to a new build at any time, so pin the version you tested.

## Three principles

- **Push and pull.** Builds go up, servers fetch them down.
- **Folders and tags.** One folder holds all the versions of one image.
- **Public or private.** Open to all, or to one team.

## Related terms

- [Docker Hub](https://learn.benibix.com/term/infrastructure/docker-hub)
- [Container Image](https://learn.benibix.com/term/infrastructure/container-image)
- [Dockerfile](https://learn.benibix.com/term/infrastructure/dockerfile)
- [CI/CD Pipeline](https://learn.benibix.com/term/development/ci-cd-pipeline)
- [npm](https://learn.benibix.com/term/development/npm)

![A row of steps from left to right. A Dockerfile is built into an image. The image is pushed up to a registry. A server pulls the image down from the registry and runs it as two containers.](https://learn.benibix.com/diagrams/inf-image-flow.svg)

---

Source: https://learn.benibix.com/term/infrastructure/container-registry
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
