431e829fa5
Simplified index again, to make access to information more obvious and more direct. Added a TLDR for people in a hurry. Signed-off-by: Olivier Gambier <olivier@docker.com>
73 lines
2.1 KiB
Markdown
73 lines
2.1 KiB
Markdown
<!--GITHUB
|
|
page_title: Docker Registry 2.0
|
|
page_description: Introduces the Docker Registry
|
|
page_keywords: registry, images, repository
|
|
IGNORES-->
|
|
|
|
# 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)
|
|
|
|
|