Balrog
Balrog is the software that runs the server side component of the update system used by Firefox and other Mozilla products.
Download
Clone from git using
$ git clone https://github.com/mozilla/balrog
Installation
To run a development environment you must have Docker and docker-compose installed (if you're on Windows or Mac you need "Docker for Windows" or "Docker for Mac" at least v1.12.0)
Once these prerequisites are installed, run the following command to create and run the necessary images:
$ docker-compose up
Once it completes, you should be able to access
- The admin interface at http://127.0.0.1:8080
- The public interface on port 9090
Tests
To execute all tests, run
$ ./run-tests.sh
For executing test only for backend, run
$ ./run-tests.sh backend
For executing test only for frontend, run
$ ./run-tests.sh frontend
Tests can also run by using tox
$ tox
Documentation
Balrog's documentation is hosted at http://mozilla-balrog.readthedocs.io/en/latest/index.html
Getting Involved
If you like to get involved in the development of Balrog there're lots of areas where we could use some help. You can take look at the bugs filed at bugzilla for Balrog Backend and Balrog Frontend.
Come talk to us in #balrog if you're interested!
If you find a problem and wish to report it, please file a bug .
License
Balrog is released under Mozilla Public License 2.0.