Skip to main content

Connecting to a local MySQL DB

FxA has several databases, for example fxa, fxa_profile and pushbox. Sometimes changes need to be made to a database, or it is helpful to read local data for development.


  • FxA running locally
  • Docker
  • mysql CLI
    • If using the mysql-client option below, this can be installed via Homebrew with brew install mysql-client.


Execute an interactive shell on the MySQL DB container and start the MySQL shell:

yarn mysql


Start the MySQL shell through the MySQL client:

mysql -uroot --host= --port=3306

Note: mysql is located in the mysql-client installation directory, e.g. at /usr/local/opt/mysql-client/bin/mysql.