Docker/Docker Compose Installation Guide

This guide provides step-by-step instructions for installing and running Beer Garden using docker. It covers both docker-compose and using the individual docker images.


For this guide we assume you have the following:

  • Docker - Installation instructions can be found at Docker Docs

  • Docker Compose - Installation instructions can be found at Docker Docs

  • Git and an account on GitHub

Installing via Docker Compose

The first step is to clone the git repository that contains the docker-compose.yml file:

git clone [email protected]:beer-garden/beer-garden.git

cd beer-garden/docker/docker-compose

In this directory you will see a docker-compose.yml file that describes the different components of Beer Garden and how they fit together. Before we can run Beer Garden we need to make one change to the configuration.

You can checkout all the options for configuration in the Configuration section

Beer Garden needs to inform remote plugins the hostname of the RabbitMQ instance that they should connect to for message. This value is set as the BG_AMQ_PUBLISH_HOST in the environment or amq_publish_host in config/command-line arguments. By default in the docker-compose.yml it will be rabbitmq. This will work for containers running on the same network, but if a truly remote plugin exists, you may need to change the value to a resolvable hostname or IP address on the network.

Make sure to use a real IP address and not 'localhost' or ''.
You can also use a fully-qualified domain name instead of an IP address.

That’s it! You’ve configured Beer Garden!


Then run this command to start Beer Garden:

docker-compose up -d

Once that finishes Beer Garden will be listening on port 2337. Point a browser at http://localhost:2337 and you’ll see a message letting you know that Beer Garden couldn’t find any systems. That’s OK - you’re about to add one!

Test your installation

We have a docker image with a very simple plugin you can use to test out your Beer Garden. Run it with this command:

docker run bgio/example-plugin --bg-host <IP-ADDRESS> --ssl-disabled

Where <IP-ADDRESS> is the same value you used during the configuration file step earlier.

The --ssl-disabled is necessary because your brand new Beer Garden doesn’t have a valid server certificate.

Start a Remote Plugin

If you have a remote plugin, you simply need to start it and point it to the host you just stood up!

Start a Local Plugin

If you have a local plugin, then this Beer Garden is ready to deploy it. Simply copy your plugin into the ./plugins/ then navigate to http://<IP-ADDRESS>:2337 then:

  1. Click on Administration on the left side of the page

  2. Click on System Administration

  3. Click Rescan System Directory at the top right of the screen

You should see your plugin appear!

If your plugin does not appear, be sure to checkout the logs using: docker-compose logs -f bartender


Run this command to stop Beer Garden.

docker-compose down