Juju Box is a docker container project that provides a configured Juju
environment with all the tools you need to work with
Juju is an open source, universal model for applications. Juju allows you to
deploy, configure, manage, maintain, and scale cloud services quickly and
efficiently on public clouds, as well as on physical servers.
This container comes with the basic tools you need to get started with Juju.
Install Docker using the package manager for your Linux distribution, or
get.docker.com. We recommend Docker version 1.6 or
Mac OS X
If you want to see the code you can download the jujubox project from
github and build it from source.
git clone https://github.com/jujusolutions/jujubox.git && cd jujubox docker build -t jujusolutions/jujubox ./
Or simply pull the jujubox container from the
docker pull jujusolutions/jujubox
There are several different ways to run jujubox depending on what you are
trying to accomplish.
Running jujubox to use Juju
If you want to use Juju run the container in an interactive (-i) tty (-t)
session and use the command line. Since the container file system is reset each
time it is highly recommended to mount a volume (-v) from the host system to
$JUJU_DATA directory. This will allow any Juju data to persist between
runs of jujubox:
docker run --rm -it \ -v $JUJU_DATA:/home/ubuntu/.local/share/juju \ jujusolutions/jujubox
Use charms from the host
If you already have charms on the host machine, you can also mount the
$JUJU_REPOSITORY directory so jujubox can deploy local charms.
docker run --rm -it \ -v $JUJU_DATA:/home/ubuntu/.local/share/juju \ -v $JUJU_REPOSITORY:/home/ubuntu/charms \ jujusolutions/jujubox
See the Environment Variables
for more information on the paths for
jujubox and the LXD provider
At this time you can not run jujubox on the LXD provider inside of Docker
because of some nested container issues. If you want to use the LXD provider
install Juju and LXD on the host system.
For more information about what you can do in jujubox check out the
If you find any bugs please create an issue in the
jujubox github repository.