This article provides tips for resolving common problems you may have while using Firefox OS. Please feel free to add more content to this page!
If you are having trouble connecting to Wi-Fi networks, it may be helpful to delete the Wi-Fi configuration file:
adb shell rm /data/misc/wifi/wpa_supplicant.conf adb reboot
Note: These instructions assume you have configured the udev settings for your device.
If you happen to brick the phone, by, for example, trying to flash wrong images on it, try rebooting into the bootloader (fastboot or heimdal depending on your phone). The exact sequence varies depending on the phone. Try removing the usb cable, removing and then re-inserting the battery. For the Unagi and Otoro, press and hold volume up and power for several seconds until you see the splash screen. Verify that the phone is in bootloader mode by using
fastboot devices (or
heimdall devices for some Samsung phones). Once you can see your phone using
fastboot devices, seek your current folder to the directory that contains a base image or the SD package files provided by the device maker (depending on your phone). Now, you have two options for flashing:
./flash.shto flash your image (recommanded).
- run the following commands from a terminal window:
fastboot flash boot boot.img fastboot flash userdata userdata.img fastboot flash system system.img fastboot flash recovery recovery.img fastboot erase cache fastboot reboot
Flashing Red LED (otoro/unagi)
This means that the battery is too low to boot the phone. You can let it charge for a while (until the red LED stops flashing and a little bit longer), or you can unplug the USB cable, remove the battery, insert the USB cable, and re-insert the battery.
Failure to receive SMS after switching over from iPhone
If you have switched your SIM card over from an iPhone to a Firefox OS (or another different platform) device, you may run into a problem whereby you can no longer receive text messages from iPhone users. This is because iPhone to iPhone SMS messages are sent using iMessage, which works by routing iPhone-to-iPhone messages through Apple's servers instead of sending them as actual text messages, saving iPhone users money. Unfortunately when you leave iPhone, iMessage has no way of knowing you've left and SMS from other iPhone users will still go through iMessage, meaning that you won't receive them.
To fix this you have to turn off iMessage for your SIM; there is a guide on how to do this at imore.com — read Here's how to turn off iMessage.
Device not appearing to ADB on OSX
When running adb devices in OSX, some devices may simply not appear in the device list, for a variety of reasons. This can be fixed by adding your device's vendor ID to your
~/.android/adb_usb.ini file, to provide a hint to ADB for finding your device.
Note: See this stackoverflow post for a lot more detail, including how to find the vendor ID of the attached device, and how to add it into