another build tool for container images
Clone or download
lucab Merge pull request #326 from dgonyeo/master
readme: add unmaintained notice
Latest commit ce911a7 Aug 24, 2017
Failed to load latest commit information.
Documentation Merge pull request #320 from sanmai-NL/patch-5 Aug 14, 2017
acbuild Error on trailing path separator in copy command. Jul 26, 2017
engine Handle host /etc/resolv.conf being a symlink Mar 9, 2017
examples fix node-build trap script Apr 16, 2017
lib Warn when begin command isn’t run as superuser Jul 12, 2017
registry lib/run: better error output when dependency doesn't exist Jan 23, 2017
scripts vagrant build uses go 1.5 Sep 25, 2016
tests Migrate appc/acbuild -> containers/build Sep 16, 2016
util oci: fix symlink targets in layers Mar 27, 2017
vendor vendor: added image-spec Jan 24, 2017
.gitignore gen-man-pages: command added to output man pages for acbuild May 25, 2016
.travis.yml replaced godeps with glide Jun 20, 2016 release: v0.4.0 Aug 10, 2016
LICENSE Initial commit Jun 4, 2015
MAINTAINERS *: add MAINTAINERS file Mar 16, 2016 Merge pull request #326 from dgonyeo/master Aug 23, 2017
Vagrantfile Workaround: install missing Virtualbox Guest Additions in Xenial Aug 8, 2016
build Merge branch 'master' into master Jul 10, 2017
build-docker Add script to build acbuild in Docker Oct 13, 2015
build-man-pages gen-man-pages: command added to output man pages for acbuild May 25, 2016
build-rkt use rkt-builder instead of my alpine; remote Jul 18, 2016
glide.lock vendor: added image-spec Jan 24, 2017
glide.yaml vendor: added image-spec Jan 24, 2017
test Migrate appc/acbuild -> containers/build Sep 16, 2016

This project is currently unmaintained

acbuild was originally created to be the tool used to build AppC images. Due to the introduction of the Open Container Initiative, development on AppC was officially suspended in November, 2016. While acbuild has the ability to also produce OCI images, it is not the only tool capable of doing so. In its current state, acbuild is not currently maintained. If you wish to become a maintainer of acbuild, feel free to start contributing and ask for direct commit access via the issue/PR tracker.

For those looking for an OCI image manipulation tool that is actively maintained, umoci or buildah might be able to fill the role.

acbuild - another container build tool

acbuild is a command line utility to build and modify container images.

It is intended to provide an image build workflow independent of specific formats; currently, it can output the following types of container images:

How to use rkt acbuild to construct app container images


We needed a powerful tool for constructing and manipulating container images that made it easy to iteratively build containers, both from scratch and atop existing images. We wanted that tool to integrate well with Unix mechanisms like the shell and Makefiles so it would fit seamlessly into well-known administrator and developer workflows.



acbuild can only be run on a Linux system, and has only been tested on the amd64 architecture.

For trying out acbuild on Mac OS X, it's recommended to use Vagrant. Instructions on how to do this are a little further down in this document.

acbuild requires a handful of commands be available on the system on which it's run:

  • cp
  • modprobe

Additionally systemd-nspawn is required to use the default engine for acbuild run. Thus on Ubuntu the systemd-container package needs to be installed.

Prebuilt Binaries

The easiest way to get acbuild is to download one of the releases from GitHub.

Build from source

The other way to get acbuild is to build it from source. Building from source requires Go 1.5+.

Follow these steps to do so:

  1. Grab the source code for acbuild by git cloneing the source repository:

    cd ~
    git clone acbuild
  2. Run the build script from the root source repository directory:

    cd acbuild

    Or, if you want to build in docker (assuming $PWD exists and contains acbuild/ on your Docker host):

    cd acbuild
  3. A bin/ directory will be created that contains the acbuild tool. To make sure your shell can find this executable, append this directory to your environment's $PATH variable. You can do this in your .bashrc or similar file, for example:

    vi ~/.bashrc

and put the following lines at the end of the file:

export ACBUILD_BIN_DIR=~/acbuild/bin

Building acbuild with rkt

If rkt is installed on the system, acbuild can also be built inside of a rkt container with the following command:


Trying out acbuild using Vagrant

For users with Vagrant 1.5.x or greater, there's a provided Vagrantfile that can quickly get you set up with a Linux VM that has both acbuild and rkt. The following steps will grab acbuild, set up the machine, and ssh into it.

git clone acbuild
cd acbuild
vagrant up
vagrant ssh


Documentation about acbuild and many of its commands is available in the Documentation directory in this repository.


Check out the examples directory for some common applications being packaged into ACIs with acbuild.

Related work