Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Firefox Accounts Content Server
JavaScript HTML CSS

Merge pull request #2458 from pdehaan/license-mpl

chore(license): Update MPL license string to be SPDX compliant r=vladikoff
latest commit ebc3bee121
@vladikoff vladikoff authored
Failed to load latest commit information.
app refactor(app): remove unused amd requires
docs Merge pull request #2442 from mozilla/issue-2423-update-permissions
grunttasks refactor(app): remove unused amd requires
locale chore(l10n): update po templates
scripts Remove grunt-blanket-mocha
server Merge pull request #2364 from mozilla/issue-2242-iframe-firstrun
tests fix(avatars): Redirect to settings/avatar/change on error
.awsbox.json add static directory configuration param and fix awsbox config
.bowerrc Fixed gitignore. Added .bowerrc.
.editorconfig feat(oauth): suggest account to use during sign up if possible
.gitattributes Generated basic Yeoman project.
.gitignore feat(experiments) allow able controlled feature flags
.jscsrc fix(jscs): allow the 'other' quote mark to be used, but only to avoid…
.jshintrc chore(jshint): eliminate lint rule for extra comma
.travis.yml fix(tests): Start the auth-db server for travis.
AUTHORS chore(authors): Add Atul Vaibhav Release v0.37.1 fix(docs): add Bower usage to CONTRIBUTING
Dockerfile feat(docker): Dockerfile and README update for basic docker developme…
Gruntfile.js fix(logging): switch to mozlog
LICENSE Add MPL 2.0 license file. chore(tests): update to selenium 2.45.0
bower.json feat(oauth): show permission screen for untrusted reliers
npm-shrinkwrap.json feat(metrics): adds DataDog integration
package.json Merge pull request #2458 from pdehaan/license-mpl

Firefox Accounts Content Server

Travis Tests: Build Status: Travis Coverage Status Functional Tests: Build Status: Functional Tests

Static server that hosts Firefox Account sign up, sign in, email verification, etc. flows.


  • node 0.10.x
  • npm
  • Grunt (npm install -g grunt-cli)
  • libgmp
    • On Linux, Install libgmp and libgmp-dev packages: sudo apt-get install libgmp3-dev
    • On Mac OS X: brew install gmp
  • fxa-auth-server running on

Development Setup

cp server/config/local.json-dist server/config/local.json
npm install
npm start

It will listen on by default.

Note: If you have issues with npm install please update to npm 2.0+ using npm install -g npm@2 (Issue #1594)

Docker Based Development

To run the content server via Docker, three steps are required:

$ docker build --rm -t mozilla/fxa_content_server .
$ docker run --rm -v $PWD:/opt/fxa mozilla/fxa_content_server npm install
$ docker run -it --rm -v $PWD:/opt/fxa --net=host mozilla/fxa_content_server

This method shares the codebase into the running container so that you can install npm and various modules required by package.json. It then runs FxA content server in a container, while allowing you to use your IDE of choice from your normal desktop environment to develop code.

Be sure to copy server/config/local.json-dist to server/config/local.json per usual before the final docker invocation to run the service.

Note to boot2docker users: you must edit your server/config/local.json to use the correct IP of your boot2docker VM. Check with the command: boot2docker ip

Then replace the public_url IP address in local.json that reads: "public_url": "" with the IP that you noted above. It should be something like

To stop the container, first try CTRL+C. If that does not work, run docker ps |grep fxa_content_server to get the hexadecimal Container ID (the first column of output). Run docker stop nnnnnnnnnnnn where the nnnn part is the Container ID.




  • Run Selenium Server
  • Run the Firefox Content Server locally: npm start
  • Run an instance of the fxa-auth-server at

e.g. in shell form:

java -jar selenium-server-standalone-2.43.1.jar &
cd fxa-auth-server
npm start &
cd ../fxa-content-server
npm start &

To run tests locally with Selenium:

npm test

To change the default auth server edit server/config/*.json on your deployed instance.

  "fxaccount_url": ""

Note that testing with Selenium via Docker does not work at present, so all testing must be carried out via your normal operating system's npm & Java tooling.

Grunt Commands

Grunt is used to run common tasks to build, test, and run local servers.

grunt build build production resources. See task source for more documentation
grunt clean remove any built production resources.
grunt lint run JSHint, JSONLint, and JSCS (code style checker) on client side and testing JavaScript.
grunt server run a local server running on port 3030 with development resources.
grunt server:dist run a local server running on port 3030 with production resources. Production resources will be built as part of the task.
grunt test run local Intern tests.
grunt version stamp a new minor version. Updates the version number and creates a new
grunt version:patch stamp a new patch version. Updates the version number and creates a new



MPL 2.0

Something went wrong with that request. Please try again.