Skip to content

beer-garden/beer-garden

Repository files navigation

Beer Garden

PyPi Version Integration Tests CodeCov

Looking for better documentation? Check out the dedicated documentation at beer-garden.io!

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.io.

Pre-requisites:

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 git@github.com:beer-garden/beer-garden.git

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/app.py -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!