README.md

Regisshtry

Super simplistic docker registry alternative. Docker save / load via ssh on remote host.

• Stores the images as tar files on a remote host
• Keeps every pushed image as independent tarball with incremental numbered file names
• Dependency-free (depends only common unix tools)

Makes deployments as easy as:

ssh $REGISSHTRY_REMOTE cat ${REGISSHTRY_PATH}/${IMAGE} | docker load

Using ssh agent forwarding you can avoid storing credentials on the host you deploy to.

File structure

regishhtry-receive receives docker images on the remote host.

It stores the images under following path:

${REGISSHTRY_PATH}/${IMAGE}     a symlink to the last pushed image.
${REGISSHTRY_PATH}/${IMAGE}.X   the actual image

where

REGISSHTRY_PATH is a configurable path to the registry
IMAGE           is the image name e.g. smallpdf/example
X               is an auto-incrementing number

Installation

• Set your local environment variables
  • REGISHHTRY_REMOTE to ssh login e.g. "user@remote-host"
  • REGISHHTRY_PATH to a remote path e.g. "/home/user/registry"
• run ./install.sh /usr/local/bin or where ever you want to install it
  • will install regisshtry-pull / regisshtry-push locally and regisshtry-receive on the remote host
• Good to go

Usage

Push image

Push a local image to the registry

regisshtry-push image

Pull image

Load a image from the registry

regisshtry-pull image