Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Beer Garden

PyPi Version Integration Tests CodeCov

Looking for better documentation? Check out the dedicated documentation at!

Beer Garden is a framework that provides a standardized interface for Command and Control of systems through the use of plugins.

Take a look at the demo:

Beer Garden Demo

Getting Started

These instructions assume you want a developer installation of Beer-garden. If you want to do work on the Beer-garden framework, this is for you! On the other hand, if you're more interested in trying out Beer-garden or working on a plugin then you may have more luck with the documentation at


Beer-garden is a Python application. As of Beer-garden version 3 the minimum required Python version is 3.7.

Beer-garden requires running RabbitMQ and MongoDB servers. If you need help installing these the docs are the place to go!

Get Up and Running

First, clone this repo:

git clone

Start the REST API

The Beer-garden application is located in src/app. Navigate to that directory and install the python dependencies:

pip install -r requirements.txt

There's a helper script for running the application in the bin directory, and example configs in the example_config directory. So an easy way to start the application is like this:

python bin/ -c example_configs/config.yaml

Start the UI

The Beer-garden frontend is located in src/ui. Navigate to that directory and install the npm dependencies:

npm install

Then you'll be able to run the development web server. This will listen on port 8080 and forward requests to the Beer-garden API to port 2337:

npm run serve

All Done

That's it! You should be able to work on Beer-garden now!