Skip to content
Branch: master
Clone or download
Latest commit e1c7944 Jun 12, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmd/gantry move main.go to gantry dir Jun 12, 2019
.gitignore expose constructor for ipfs ref May 31, 2019
Makefile IPNS Jun 11, 2019
gantry.jpg initialise May 13, 2019
go.mod initialise May 13, 2019
go.sum initialise May 13, 2019


Move container images to and from IPFS.

A container crane (also container handling gantry crane or ship-to-shore crane) is a type of large dockside gantry crane found at container terminals for loading and unloading intermodal containers from container ships.


A tall framework supporting a space rocket prior to launching.

The Open Container Initiative currently maintains specifications for images and runtimes which have been implemented by the containers organization - specifically libraries such as this and tools such as Buildah and Podman. Gantry adapts some of these interfaces to further leverage IPFS as a storage backend to host all layers that comprise an image, located at the Content Identifier (CID) of it's manifest. This allows anyone with knowledge of the manifest to pull the whole image from anywhere in the world.


Getting Started


Download any image to your local store:

buildah from alpine

The only way to publish an image is to run a local IPFS node. You can then push the image to your local repo, and clear the local image store:

image=$(gantry push -o alpine)
buildah rmi --all

Finally, re-download the image from IPFS and check it exists:

gantry pull -o $image -t alpine
buildah images


You may need to enable user namespace cloning in the kernel:

sysctl -w kernel.unprivileged_userns_clone=1
You can’t perform that action at this time.