distribution/docs/dockerhub.md

Distribution

This repository provides container images for the Open Source Registry implementation for storing and distributing container artifacts in conformance with the OCI Distribution Specification.

Quick start

Run the registry locally with the default configuration:

docker run -d -p 5000:5000 --restart always --name registry distribution/distribution:edge

NOTE: in order to run push/pull against the locally run registry you must allow your docker (containerd) engine to use insecure registry by editing /etc/docker/daemon.json and subsequently restarting it

{
     "insecure-registries": ["host.docker.internal:5000"]
}

Now you are ready to use it:

docker pull alpine
docker tag alpine localhost:5000/alpine
docker push localhost:5000/alpine

⚠️ Beware the default configuration uses filesystem storage driver and the above example command does not mount a local filesystem volume into the running container. If you wish to mount the local filesystem to the rootdirectory of the filesystem storage driver run the following command:

docker run -d -p 5000:5000 -v $PWD/FS/PATH:/var/lib/registry --restart always --name registry distribution/distribution:edge

Custom configuration

If you don't wan to use the default configuration file, you can supply your own custom configuration file as follows:

docker run -d -p 5000:5000 -v $PWD/PATH/TO/config.yml:/etc/distribution/config.yml --restart always --name registry distribution/distribution:edge

Communication

For async communication and long-running discussions please use issues and pull requests on the GitHub repo.

For sync communication we have a #distribution channel in the CNCF Slack that everyone is welcome to join and chat about development.