# Docker Registry ## What it is The Registry is a stateless, highly scalable server side application that stores and lets you distribute Docker images. The Registry is open-source, under the permissive [Apache license](http://en.wikipedia.org/wiki/Apache_License). ## Why use it You should use the Registry if you want to: * tightly control where your images are being stored * fully own your images distribution pipeline * integrate images storage and distribution into your inhouse, on premises development workflow ## Alternatives Users looking for a zero maintenance, ready-to-go solution are encouraged to head-over to the [Docker Hub](https://hub.docker.com), which provides a free-to-use, hosted Registry, plus additional features (organization accounts, automated builds, and more). Users looking for a commercially supported version of the Registry should look into [Docker Hub Enterprise](https://docs.docker.com/docker-hub-enterprise/). ## Requirements The Registry is compatible with Docker engine version 1.6.0 or higher. If you really need to work with older Docker versions, you should look into the [old python registry](https://github.com/docker/docker-registry) ## TL;DR ``` # Start your registry docker run -d -p 5000:5000 registry:2 # Pull (or build) some image docker pull ubuntu # Name the image to point to your registry docker tag ubuntu localhost:5000/myfirstimage # Push it docker push localhost:5000/myfirstimage # Pull it docker pull localhost:5000/myfirstimage ``` Simple as that? Yes. Now, please read the... ## Documentation - [Introduction](introduction.md) - [Deployment](deploying.md) - [Configuration](configuration.md) - [Getting help](help.md) - [Contributing](../CONTRIBUTING.md) Advanced topics: - [Authentication](authentication.md) - [Working with notifications](notifications.md) - [Advanced ops](advanced.md) Development resources: - [Storage driver model](storagedrivers.md) - [Registry API](spec/api.md)