garden cli
Switch branches/tags
Nothing to show
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
Godeps Update vendor packages to latest Dec 10, 2018
commands Add set-gracetime command Dec 10, 2018
docs/images modernise the README Aug 22, 2016
scripts this is not concourse what is going on May 25, 2016
test Optional bind mount mode Mar 19, 2018
vendor Update vendor packages to latest Dec 10, 2018
LICENSE add readme and license Jan 24, 2015 bleugh Aug 22, 2016
gaol.go add grace time to command list Dec 10, 2018


A CLI for Garden

MIT License


Gaol is a simple, fast, and composable CLI for the Garden container server. It is designed to be used with other command line tools. It is suitable for use in scripts and other headless operations.


Download the latest binary from the releases page, make it executable, and put it somewhere in your path.


All of the commands are documented in the help and usage section of the CLI. You can see this by running:

gaol --help

Some of the more common commands are:

# creating a container
$ gaol create

# run a command inside a container
$ gaol run conabc123 --attach --command "date"
Sat  7 Feb 2015 15:14:17 GMT

# run a process in the background and then attach to it
$ gaol run conabc123 --command 'sh -c "while true; do date; sleep 1; done"'
$ gaol attach conabc123 --pid 5
Sat  7 Feb 2015 15:14:45 GMT
Sat  7 Feb 2015 15:14:46 GMT
Sat  7 Feb 2015 15:14:47 GMT

# open a shell inside a new container
$ gaol shell $(gaol create)

# copying files into a container
$ tar c file.txt | gaol stream-in conabc123 --destination /etc/file.txt

# copying files from one container to another
$ gaol stream-out abc -s ./foo | gaol stream-in def -d ./foo

# destroy all containers
$ gaol list | xargs gaol destroy



Gaol Definition