Skip to content
Next generation update service for Mozilla products
Python Shell
Find file
Failed to load latest commit information.
aus-data-snapshots Fix up issues in locale-level-overrides test; address more pep8 stuff… Dec 15, 2015
auslib bug 1251338: Send e-mail when changes are made to rules or permission… Apr 20, 2016
scripts bug 1266392: Add link to Taskcluster build in version.json; create ar… Apr 21, 2016
ui @ ceb80aa bug 1127875: return data_version in response from read only state cha… Apr 5, 2016
uwsgi bug 1251338: Send e-mail when changes are made to rules or permission… Apr 20, 2016
vendor Undo revert of latest work now that production has backed out code. Jan 29, 2016
.coveragerc Move coverage config to .coveragerc, turn on branch coverage, and sto… Jan 13, 2016
.dockerignore Add docker-compose support Feb 12, 2016
.gitignore Switch to very simple wsgi file for Docker; kill configs and associat… Dec 18, 2015
.gitmodules bug 1096531: figure out how to integrate new balrog ui with existing … Nov 20, 2014
.hgignore bug 668345: create initial testing framework for AUS3 - merge in all … Jul 18, 2011
.taskcluster.yml Tweak test scripts + .taskcluster.yml to use new run-tests.sh to run … Apr 19, 2016
Dockerfile Include .coveragerc in Dockerfile to make sure it gets used when runn… Apr 19, 2016
MANIFEST.in Include version.txt in MANIFEST.in. Mar 2, 2016
README Add info on finding docker IP on mac/windows, r=bhearsum Mar 17, 2016
admin.wsgi bug 1251355: replace cef logging with mozlog. r=nthomas,ulfr Mar 21, 2016
balrog.wsgi bug 1251355: replace cef logging with mozlog. r=nthomas,ulfr Mar 21, 2016
docker-compose-test.yml Tweak test scripts + .taskcluster.yml to use new run-tests.sh to run … Apr 19, 2016
docker-compose.yml bug 1251338: Send e-mail when changes are made to rules or permission… Apr 20, 2016
requirements-test.txt Add script and other necessities to run tests in Docker (closes #69).… Apr 18, 2016
requirements.txt bug 1251355: replace cef logging with mozlog. r=nthomas,ulfr Mar 21, 2016
run-tests.sh Don't save balrogtest Docker images. r=rail Apr 29, 2016
setup.py Add hashes to requirements.txt. Mar 9, 2016
tox.ini Tweak test scripts + .taskcluster.yml to use new run-tests.sh to run … Apr 19, 2016
version.json bug 1266392: Add link to Taskcluster build in version.json; create ar… Apr 21, 2016
version.txt Move version to a file; create version.json as part of docker build s… Mar 1, 2016

README

Balrog is a rewrite of the Application Update Server used by Mozilla to
provide updates to Firefox. It uses a database to store a series of rules
which map update requests to releases. Documentation is available at
https://wiki.mozilla.org/Balrog.

To run a development environment you must have Docker and docker-compose
installed (if you're on Windows or Mac you probably want Docker Machine as
well). Once these prerequisites are installed, run the following command to
create  and run the necessary images:

  docker-compose up

MySQL data will persist across runs and stored under `.cache/mysql`. To reset
the data, you can delete the directory and run `docker-compose up`.

Now you should be able to access the admin interface at:
http://127.0.0.1:8080

And you can access the public interface with URLs such as:
http://127.0.0.1:9090/update/3/Firefox/33.0/20141202185629/Darwin_x86_64-gcc3-u-i386-x86_64/en-US/release/default/default/default/update.xml?force=1

If you're on Mac, Windows, or running Docker in a VM for another reason, you'll need to replace 127.0.0.1 with the IP of your VM. eg with 'docker-machine ip'

Something went wrong with that request. Please try again.