{"id":13764915,"url":"https://github.com/mozilla-releng/balrog","last_synced_at":"2026-02-24T16:05:10.778Z","repository":{"id":1744598,"uuid":"2570444","full_name":"mozilla-releng/balrog","owner":"mozilla-releng","description":"Mozilla's Update Server","archived":false,"fork":false,"pushed_at":"2025-12-11T12:52:04.000Z","size":75653,"stargazers_count":103,"open_issues_count":122,"forks_count":154,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-12-12T14:15:15.242Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://mozilla-balrog.readthedocs.io/en/latest/index.html","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mozilla-releng.png","metadata":{"files":{"readme":"README.rst","changelog":"HISTORY.rst","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2011-10-13T15:51:47.000Z","updated_at":"2025-12-11T12:52:08.000Z","dependencies_parsed_at":"2023-10-20T21:54:10.817Z","dependency_job_id":"d77e23e7-277d-4b2f-86f4-a0d9d63bb766","html_url":"https://github.com/mozilla-releng/balrog","commit_stats":{"total_commits":2150,"total_committers":115,"mean_commits":"18.695652173913043","dds":0.6004651162790697,"last_synced_commit":"6c6cbc803960c89ae4b427fa1372d16ab65fbaf8"},"previous_names":[],"tags_count":227,"template":false,"template_full_name":null,"purl":"pkg:github/mozilla-releng/balrog","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mozilla-releng%2Fbalrog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mozilla-releng%2Fbalrog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mozilla-releng%2Fbalrog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mozilla-releng%2Fbalrog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mozilla-releng","download_url":"https://codeload.github.com/mozilla-releng/balrog/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mozilla-releng%2Fbalrog/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28247284,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2026-01-08T02:00:06.591Z","response_time":241,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T16:00:31.518Z","updated_at":"2026-02-24T16:05:10.753Z","avatar_url":"https://github.com/mozilla-releng.png","language":"Python","readme":"|CI| |Coverage|\n\nBalrog is the software that runs the server side component of the update system used by Firefox and other Mozilla products.\n\nInstallation\n============\nTo run a development environment you must have Docker and docker-compose\ninstalled (if you're on Windows or Mac you need \"Docker for Windows\" or \"Docker\nfor Mac\" at least v1.12.0)\n\nIf you have access to it, set up the machine token for the Agent. If you don't have access to it, just skip this step. The Agent will not function, but everything else will work.\n::\n\n    $ export AUTH0_M2M_CLIENT_SECRET=abcdef123456\n\nRun the following command to create and run the necessary containers:\n::\n\n    $ docker-compose up\n\n**Note**\n\n*On ARM (M1) chips*\n\nMake sure you are running a recent version of docker compose:\n::\n\n    $ docker-compose version\n    Docker Compose version v2.2.3\n\nThen, run the following command to create and run the necessary containers:\n::\n\n    $ docker-compose -f docker-compose.yml -f docker-compose.arm.yml up\n\nOnce it completes, you should be able to access\n\n- http://localhost:9010 - The public API\n- https://localhost:9011 - The admin API\n- https://localhost:9000 - The admin interface\n- http://localhost:8050 - A graphite interface\n\nYou'll need to accept the self signed SSL certificates in your browser for each of the https links above for everything (especially the UI) to function correctly.\n\nYou'll need to use the \"Sign in...\" button to do anything useful with the admin interface, which will ask you to sign in with a third party provider (eg: gmail, github). Once you've done that, run the following to create a local admin user to gain write access:\n::\n\n    $ export LOCAL_ADMIN=\u003cemail address you signed in with\u003e\n    $ docker-compose run balrogadmin create-local-admin\n\n\nTests\n=====\nTo execute all tests, simply run:\n::\n\n    $ tox\n\nThis will run all unit tests within a Docker container.\n\nUpdating dependencies\n=====================\n\nTo update the python dependencies, use `uv lock -U`.\n\nDocumentation\n=============\n\nBalrog's documentation is hosted at http://mozilla-balrog.readthedocs.io/en/latest/index.html\n\nLicense\n=======\nBalrog is released under `Mozilla Public License 2.0 \u003chttps://opensource.org/licenses/MPL-2.0\u003e`_.\n\n\n.. |CI| image:: https://firefox-ci-tc.services.mozilla.com/api/github/v1/repository/mozilla-releng/balrog/main/badge.svg\n   :target: https://firefox-ci-tc.services.mozilla.com/api/github/v1/repository/mozilla-releng/balrog/main/latest\n.. |Coverage| image:: https://coveralls.io/repos/github/mozilla-releng/balrog/badge.svg?branch=HEAD\n   :target: https://coveralls.io/github/mozilla-releng/balrog?branch=HEAD\n","funding_links":[],"categories":["Software"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmozilla-releng%2Fbalrog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmozilla-releng%2Fbalrog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmozilla-releng%2Fbalrog/lists"}