Stackbrew is a web-application that performs continuous building of the docker standard library. See README.md in the stackbrew subfolder for more information.

The library definition files are plain text files found in the library/ subfolder of the stackbrew repository.

The name of a definition file will determine the name of the image(s) it creates. For example, the library/ubuntu file will create images in the <namespace>/ubuntu repository. If multiple instructions are present in a single file, all images are expected to be created under a different tag.

Each line represents a build instruction. There are different formats that Stackbrew is able to parse.

<git-url>
git://github.com/dotcloud/hipache
https://github.com/dotcloud/docker.git

The simplest format. Stackbrew will fetch data from the provided git repository from the HEADof its master branch. Generated image will be tagged as latest. Use of this format is discouraged because there is no way to ensure stability.

<docker-tag> <git-url>
bleeding-edge git://github.com/dotcloud/docker
unstable https://github.com/dotcloud/docker-redis.git

A more advanced format. Stackbrew will fetch data from the provided git repository from the HEADof its master branch. Generated image will be tagged as <docker-tag>. Recommended if we always want to provide a snapshot of the latest development. Again, no way to ensure stability.

<docker-tag>	<git-url>	T:<git-tag>
2.4.0 	git://github.com/dotcloud/docker-redis	T:2.4.0
<docker-tag>	<git-url>	B:<git-branch>
zfs		https://github.com/dotcloud/docker.git	B:zfs-support
<docker-tag>	<git-url>	C:<git-commit-id>
2.2.0 	git://github.com/dotcloud/docker-redis C:a4bf8923ee4ec566d3ddc212

The most complete format. Stackbrew will fetch data from the provided git repository from the provided reference (if it's a branch, Stackbrew will fetch its HEAD). Generated image will be tagged as <docker-tag>. Recommended whenever possible.

Thank you for your interest in the stackbrew project! We strive to make these instructions as simple and straightforward as possible, but if you find yourself lost, don't hesitate to seek us out on IRC freenode, channel #docker or by creating a github issue.

• Create a new file in the library folder. Its name will be the name of your repository.
• Add your tag definitions using the provided syntax (see above).
• Add the following line to the MAINTAINERS file: repo: Your Name (github.name) <you@email.com>
• Create a pull request from your git repository to this one. Don't hesitate to add details as to what your repository does.

• Add your tag definition using the
• Create a pull request from your git repository to this one. Don't hesitate to add details.
• In the pull request, mention the repository's maintainer using the @ symbol.

• Propose a pull request to the origin repository. Don't hesitate to @-mention one of the stackbrew maintainers.