Use Troubleshoot Mode in Firefox
Revision Information
- Revision id: 26851
- Created:
- Creator: Michael Verdi
- Comment: New 160 character search summary
- Reviewed: Yes
- Reviewed:
- Reviewed by: Verdi
- Is approved? Yes
- Is current revision? No
- Ready for localization: No
Revision Source
Revision Content
Safe Mode is a special Firefox execution mode that can be used to troubleshoot issues in Firefox. In Safe Mode, you can reset some settings or disable add-ons that might be the source of the issue. By comparing Firefox behavior in normal mode to its behavior in Safe Mode, where various items are disabled, you may be able to diagnose issues.
Note: Windows users may be familiar with a Safe Mode for Windows. Firefox Safe Mode has no connection to Windows Safe Mode.
Note: The Refresh Firefox feature can fix many issues by restoring Firefox to its default state while saving your essential information. Consider using it before going through a lengthy troubleshooting process.
How to start Firefox in Safe Mode
Click the menu button , click , select and click in the Restart Firefox in Troubleshoot Mode? dialog.
Note: You can also start Firefox in Troubleshoot Mode by holding down the Shift key while starting Firefox.holding down the option key while starting Firefox.quitting Firefox and then going to your Terminal and running:
You may need to specify the Firefox installation path (for example /usr/lib/firefox).
firefox -safe-mode
You may need to specify the Firefox installation path (for example /usr/lib/firefox).
Safe Mode window
You now have three options:
- Clicking the button cancels your attempt to get into Firefox's Safe Mode.
- Clicking the button starts Firefox in its Safe Mode. While you are in Safe Mode, your extensions and themes will be disabled, and any toolbar customizations will be reverted back to their defaults. These changes are temporary - when you leave Safe Mode and start Firefox up normally, your extensions, themes, and settings will return to the state they were in before you entered Safe Mode.
- The button is only enabled if you select one of the boxes above it.
You can elect to make the following changes:
Warning: When you make these changes and restart Firefox, they will remain in effect from that point on, unless you take additional steps to undo them. Some changes cannot be undone.
- Disable all add-ons: If you select this box and then click this article if you need more help enabling your add-ons. then Firefox will start back up in its normal mode, except all your extensions, themes and plugins will be disabled (not uninstalled). To undo the change, you will need to enable each extension and plugin listed in the Add-ons Manager. See
- Reset toolbars and controls: If you select this box and then click Customize Firefox controls, buttons and toolbars for more help. then Firefox will start back up in its normal mode except any toolbar customizations you have made will be lost, such as position of buttons and toolbars. If you later want to undo this change, you will need to add back those customizations. See
- Delete all bookmarks except for backups: If you select this box and then click (this item is labeled Reset bookmarks to Firefox defaults in Firefox 3.5). If you later want to undo the change, you will need to restore your bookmarks from backup. See Restore bookmarks from backup or move them to another computer for more help. then Firefox will delete your current bookmarks and replace them with the default set
- Reset all user preferences to Firefox defaults: If you select this box and then click then changes you have made to Firefox options and preferences will be set back to the default settings. This change will be hard to undo, since you may not remember all of the settings you have changed.
- Restore default search engines: If you select this box and then click Search Bar and remove the search engines you don't want. then any of the default search engines you deleted will be restored. This does not remove any added search engines. To undo this change, simply go to the
Exiting Safe Mode
- Click the Firefox menu
and select .Click the Firefox menu at the top of the screen and select .Click the Firefox menu
and select .
- Start Firefox as you normally would.
- If Firefox keeps starting in Safe Mode, see Firefox is stuck in Troubleshoot Mode.
Based on information from Safe mode (mozillaZine KB)