An experimental go library providing Compose-like functionality
Go Shell Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
cli Fixed Vendor for `sirupsen/logrus` Oct 25, 2017
config fixes to get tests passing for compose >2.x support (yml parsing) Aug 21, 2018
docker Update docker version and client create arguments Aug 15, 2018
example Fix example Oct 31, 2016
hack Fixed Vendor for `sirupsen/logrus` Oct 25, 2017
integration Fixed Vendor for `sirupsen/logrus` Oct 25, 2017
labels Move Label into their own package May 7, 2016
logger Adding standard LoggerFactory for image building and pulling Jul 8, 2016
lookup Fixed Vendor for `sirupsen/logrus` Oct 25, 2017
project Fixed Vendor for `sirupsen/logrus` Oct 25, 2017
samples add a simple Go program using the parser Jul 6, 2015
utils Fixed Vendor for `sirupsen/logrus` Oct 25, 2017
vendor Update docker version and client create arguments Aug 15, 2018
version Bump version to 0.4.0… Jan 10, 2017
yaml Fix GetServiceHash failed due to false hashing *yaml.Networks & *yaml… Jun 19, 2017
.dockerignore Add **/*.test to .dockerignore Apr 4, 2016
.gitignore Update example #261 May 23, 2016 Rename CHANGES to CHANGELOG Aug 13, 2015 Add some info to Aug 13, 2015
Dockerfile Update golang image version Jul 3, 2017
Jenkinsfile Add a SHOWNOWARNING constant to hide warning message Jun 21, 2016
LICENSE Initial Commit Jul 19, 2015
MAINTAINERS Add Josh Curl as maintainer May 18, 2016
Makefile Rename script folder to hack Sep 30, 2016 Rename script folder to hack Sep 30, 2016
package.go Initial Commit Jul 19, 2015
vendor.conf Update docker version and client create arguments Aug 15, 2018


GoDoc Build Status

A Go library for Docker Compose. It does everything the command-line tool does, but from within Go -- read Compose files, start them, scale them, etc.

Note: This is experimental and not intended to replace the Docker Compose command-line tool. If you're looking to use Compose, head over to the Compose installation instructions to get started with it.

Here is a list of known project that uses libcompose:


package main

import (



func main() {
	project, err := docker.NewProject(&ctx.Context{
		Context: project.Context{
			ComposeFiles: []string{"docker-compose.yml"},
			ProjectName:  "my-compose",
	}, nil)

	if err != nil {

	err = project.Up(context.Background(), options.Up{})

	if err != nil {


You need either Docker and make, or go in order to build libcompose.

Building with docker

You need Docker and make and then run the binary target. This will create binary for all platform in the bundles folder.

$ make binary
docker build -t "libcompose-dev:refactor-makefile" .
# […]
---> Making bundle: binary (in .)
Number of parallel builds: 4

-->      darwin/386:
-->    darwin/amd64:
-->       linux/386:
-->     linux/amd64:
-->       linux/arm:
-->     windows/386:
-->   windows/amd64:

$ ls bundles
libcompose-cli_darwin-386*    libcompose-cli_linux-amd64*      libcompose-cli_windows-amd64.exe*
libcompose-cli_darwin-amd64*  libcompose-cli_linux-arm*
libcompose-cli_linux-386*     libcompose-cli_windows-386.exe*

Building with go

  • You need go v1.5 or greater
  • If you are not using go v1.6, you need to set export GO15VENDOREXPERIMENT=1 environment variable
  • If your working copy is not in your GOPATH, you need to set it accordingly.
$ go generate
# Generate some stuff
$ go build -o libcompose ./cli/main


A partial implementation of the libcompose-cli CLI is also implemented in Go. The primary purpose of this code is so one can easily test the behavior of libcompose.

Run one of these:


Tests (unit & integration)

You can run unit tests using the test-unit target and the integration test using the test-integration target. If you don't use Docker and make to build libcompose, you can use go test and the following scripts : hack/test-unit and hack/test-integration.

$ make test-unit
docker build -t "libcompose-dev:refactor-makefile" .
---> Making bundle: test-unit (in .)
+ go test -cover -coverprofile=cover.out ./docker
ok     0.019s  coverage: 4.6% of statements
+ go test -cover -coverprofile=cover.out ./project
ok    0.010s  coverage: 8.4% of statements
+ go test -cover -coverprofile=cover.out ./version
ok    0.002s  coverage: 0.0% of statements

Test success

Current status

The project is still being kickstarted... But it does a lot. Please try it out and help us find bugs.


Want to hack on libcompose? Docker's contributions guidelines apply.

If you have comments, questions, or want to use your knowledge to help other, come join the conversation on IRC. You can reach us at #libcompose on Freenode.