Firefox Git Migration Status
May 2025
On the 30th April 2025 we successfully migrated the source of truth for Firefox from Mercurial to Git - see the previous Firefox Git Migration Update for more details.
Action Required
- To ensure full functionality make sure you're running the latest version of moz-phab, version 1.9.0 run moz-phab self-update
- Plan to migrate your local repository to Git as soon as is viable; we recommend coordinating your migration with other engineers you work closely with
Workstation Migration
Your local work will need to be migrated from a hg/git-cinnabar clone of Mercurial's repository to a vanilla Git clone from GitHub after we have migrated the infrastructure.
The simplest option, and the one we recommend for most users, is to move commits on an as-required basis:
- Clone the firefox repository: git clone https://github.com/mozilla-firefox/firefox.git
- You can add --depth 1 to the command for a faster clone that excludes the complete history, although some features such as artifact builds might not be functional yet
- Export commits from your existing repository
- Use hg export or git format-patch
- Apply the patch(es) to the new git repository
- For most this will likely involve creating a new branch then using git am or git apply to apply the patches
gecko-dev
The current GitHub mirror of mozilla-central - https://github.com/mozilla/gecko-dev/ - will continue to operate for at least a month after the migration.
At some point we will archive gecko-dev and decommission the service that is keeping it up-to-date.
Repository Map
Questions?
Join #engineering-workflow on Mozilla Slack.