Welcome to Firefox Accounts!

Firefox Accounts is the authentication and authorization system for Cloud Services at Mozilla, providing access to services such as Firefox Sync and Firefox Hello.

This documentation is for contributors wanting to help develop and maintain the Firefox Accounts service. We have separate documentation for other purposes:

Using your Firefox Account

You can create an account or sign in directly on https://accounts.firefox.com, but you almost certainly want to start by using an account-attached service such as Firefox Sync or Firefox Hello.

More information is available on Mozilla's support site.

Integrating with Firefox Accounts

Developing a service that needs Firefox Accounts authentication? Head on over to the Firefox Accounts portal on MDN for a description of the system, how it works, and how to plug into it.

Note that all services integrating with Firefox Accounts require approval (and access credentials) from Mozilla. We are not yet offering Firefox Accounts authentication to third-party reliers on the web.

People and Places

These fine folks are the globally distributed team at the core of Firefox Accounts development, and will be happy to help answer any questions you might have:

We meet regularly to triage bugs and make grand plans for the future. Anyone is welcome to join us in the following forums:


We mostly follow a micro-services architecture, with each component of the system being developed in a separate repository. The main components fit together like so:

High-level architecture diagram showing relationships between different FxA services

LucidChart View

Edit Component Chart

Most repositories are available via GitHub

You can read more about the details of our development process

Core Servers



Most of our work takes place on github, and we use waffle.io to provide an overview of bug status and activity:

If you have found a bug in FxA, please file it via the dashboard above

There is also a "Core/FxAccounts" bugzilla component that covers the accounts code inside Firefox itself, and a "Server: Firefox Accounts" component for when FxA code interacts with parts of Mozilla that operate out of bugzilla:

How To