Last updated:
35% of users voted this helpful
Troubleshoot Mode runs Thunderbird with some features and customizations disabled, so you can see whether the cause of your problem is one of the disabled items. The disabling is temporary unless you choose to make the changes permanent. The list of disabled items is detailed below.
Troubleshoot Mode does not affect your data.
Table of Contents
Starting Thunderbird in Troubleshoot Mode
- Switch to Troubleshoot Mode:
- If Thunderbird is not running: Hold down the Shift key while starting Thunderbird.Hold down the option key while starting Thunderbird.From Terminal, run this command:
thunderbird -safe-mode
You may need to specify the Thunderbird installation path (e.g. /usr/lib/thunderbird or ~/Downloads/thunderbird/thunderbird). - If Thunderbird is already running: Click > > and in the Restart in Troubleshoot Mode prompt, choose .
- If Thunderbird is not running: Hold down the Shift key while starting Thunderbird.Hold down the option key while starting Thunderbird.From Terminal, run this command:
- In the Thunderbird Troubleshoot Mode dialog, click button.
- If you want Troubleshoot Mode changes to be temporary, do not check the checkboxes - temporary is the default. But you can choose to make the changes permanent.
- Click > and check if you see in the menu, to confirm that Thunderbird is currently running in Troubleshoot Mode.
Turning Troubleshoot Mode off
Click > > to immediately close Thunderbird and restart it in normal mode.
Or you can just exit Thunderbird and start as you normally would.
Diagnosing problems in Troubleshoot Mode
After you start Thunderbird in Troubleshoot Mode, test its behavior to see if the problem goes away.
The problem still happens in Troubleshoot Mode
If the problem still happens in Troubleshoot Mode, then it is not being caused by an extension or theme installed in Thunderbird. Possible causes and solutions include:
- Something wrong with your Windows operating system or operating environment. Please start Windows in safe mode. If the problem is resolved in Windows safe mode, then the cause is likely a program loaded during windows startup. Possibilities include: antivirus software (AV), virus/malware, background downloads such as Windows or other program updates, to name a few. For AV information see https://wiki.mozilla.org/Thunderbird:Testing:Antivirus_Related_Performance_Issues.
- Something wrong with your Thunderbird installation. Please try reinstalling Thunderbird from https://www.thunderbird.net/.
- Something is wrong with your Thunderbird installation: If you had installed Thunderbird using the Linux package manager, try reinstalling it. Also investigate possible library conflicts, and consider using the Thunderbird supplied package from https://www.thunderbird.net/.
- A problem with your mail provider. For example not being able to recieve or not being able to send messages.
- Changes made to Thunderbird preference settings not disabled in Troubleshoot Mode. You might try creating a new profile. (But do not delete your current profile.)
- A bug in Thunderbird. Ask for help to determine if it is a bug. Please file a bug if you have determined with help that the problem is with Thunderbird.
The problem no longer happens in Troubleshoot Mode
If the problem no longer happens in Troubleshoot Mode, the most likely cause is an extension, theme or hardware acceleration. Possible solutions include switching back to normal mode, then doing the following. (You may need to restart Thunderbird after each step to see if it solves the problem.)
- Progressively disable extensions in the add-ons manager: Click > > , then check if the problem remains after disabling each extension. When the problem goes away, the last disabled extension is probably the trouble causer. You can try to update it, reinstall it, leave it disabled, or remove it.
- Set the default theme in the add-ons manager: Click > > , then enable the default theme.
- Try turning off hardware acceleration in Thunderbird's settings: Click > > , then uncheck .
What does Troubleshoot Mode disable?
- Add-ons (extensions and themes)
- Hardware acceleration
- Window and sidebar size and position settings (described in terms of Firefox)
- userChrome and userContent customizations ; see userChrome.css and .js and userContent are unsupported
- JavaScript Just-in-time (JIT) compiler
