8,539 latest version

1.9 quality score

Version information

  • 0.2.0 (latest)
  • 0.1.0
  • 0.0.9
  • 0.0.8
  • 0.0.7
  • 0.0.6
  • 0.0.5
  • 0.0.4
  • 0.0.2
  • 0.0.1
released Nov 13th 2014

Start using this module


markb/docker_registry — version 0.2.0 Nov 13th 2014


####Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with docker_registry
  1. Usage - Configuration options and additional functionality
  2. Reference - An under-the-hood peek at what the module is doing and how coming soon
  3. Limitations - OS compatibility, etc.
  4. Development - Guide for contributing to the module


The docker_registry module delploys a private docker registry.

##Module Description

Docker is an open platform for developers and sysadmins to build, ship, and run distributed applications. Consisting of Docker Engine, a portable, lightweight runtime and packaging tool, and Docker Hub, a cloud service for sharing applications and automating workflows, Docker enables apps to be quickly assembled from components and eliminates the friction between development, QA, and production environments. As a result, IT can ship faster and run the same app, unchanged, on laptops, data center VMs, and any cloud.

The Docker registry offers some of the same functionality as the Docker Hub. It can be installed and administered privately where business, network, and other concerns prohibit the use of a third party hub.

Please note that the deployed registry will be insecure.


###affected components

  • This module adds the requisite repositories and packages for running the docker registry, then starts the service.
  • This is an alpha stage module; not intended for production use.

###Setup Requirements

on ubuntu, make sure ruby 1.9.x is installed.

###getting started


puppet module install markb-docker_registry-0.2.0.tar.gz

puppet apply -e 'include docker_registry'

you'll want to stop the docker service and start a daemon with the insecure flag:

docker -d --insecure-registry localhost:5000

then you can use the following to see that the registry is working:

docker search tutorial
docker pull learn/tutorial
docker run learn/tutorial apt-get install -y ping
docker ps -a
docker commit <hash from last command> localhost:5000/tutorialWithPing
docker push localhost:5000/tutorialWithPing


include docker_registry




This module will only work for Debian and Rel variants. It's only been tesed on CentOs 6.5 and Ubuntu 12.04 at this point. Feedback and errata on other distros/versions is eagerly anticipated.


Please see the Github repository to contribute.