brandon/oam
1
0
Fork 0
mirror of https://gitea.com/mcereda/oam.git synced 2026-02-09 05:44:23 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
23f3c9401754b93abd707e64fdda589ec46b3f70
oam/knowledge base/thunderbird.md
Michele Cereda 23f3c94017 fix: paths in thunderbird
2023-07-30 01:04:29 +02:00

5.3 KiB
Raw Blame History

Mozilla Thunderbird

Table of contents

  1. TL;DR
  2. Profiles
    1. Profile manager
    2. Backing up profiles
    3. Restoring profiles from backups
  3. Troubleshooting
    1. Rebuild the Global Database for a Profile
  4. Sources

TL;DR

Default directories path:

Directory Linux Mac OS X Windows
Binaries /usr/bin /Applications/Thunderbird.app/Contents/MacOS C:\Program Files\Mozilla Thunderbird
Data ${HOME}/.thunderbird ${HOME}/Library/Thunderbird %APPDATA%\Roaming\Thunderbird

Profiles

Sets of files where Thunderbird saves personal information such as messages, passwords and user preferences.
One can have multiple profiles, each containing a separate set of user information.

The Profile Manager allows to create, remove, rename, and switch profiles.

Profile manager

When Thunderbird is open:

  1. Open the hamburger menu on the top right, or look at the menu bar.
  2. Choose Help > Troubleshooting Information.
  3. On the page that opens, click the about:profiles link.

When Thunderbird is closed:

${THUNDERBIRD_BIN_DIR}/thunderbird --ProfileManager
${THUNDERBIRD_BIN_DIR}/thunderbird-bin -P

Backing up profiles

  1. Close Thunderbird if it is open.
  2. Copy the profile folder to another location: 
    cp -a "${THUNDERBIRD_DATA_DIR}/Profiles/we12yhij.default" "/Backup/Thunderbird/we12yhij.default"

Restoring profiles from backups

  1. Close Thunderbird if it is open.
  2. If the existing profile folder and the profile backup folder have the same name, replace the existing profile folder with the profile backup folder: 
    rm -fr "${THUNDERBIRD_DATA_DIR}/Profiles/we12yhij.default"
cp -a "/Backup/Thunderbird/we12yhij.default" "${THUNDERBIRD_DATA_DIR}/Profiles/we12yhij.default"

    Important: The profile folder names must match exactly for this to work, including the random string of 8 characters.

  3. If the profile folder names do not match, or to move or restore a profile to a different location:
    1. Use the Profile Manager to create a new profile in the desired location, then exit the Profile Manager.
    2. Open the profile's backup folder.
    3. Copy the entire contents of the profile's backup folder.
      This includes the mimeTypes.rdf, prefs.js and the other files.
    4. Locate and open the new profile folder.
    5. Paste the copied contents into the new profile's folder.
      Overwrite existing files of the same name.
    6. Open up the profiles.ini file in the application data folder in a text editor. 
      vim "${THUNDERBIRD_DATA_DIR}/profiles.ini"
    7. Check the Path= line for the profile is correct.
  4. Start Thunderbird.

Troubleshooting

Rebuild the Global Database for a Profile

The Global Database is the indexing system that enables Thunderbird to search messages.
Rebuilding the Global Database re-indexes messages and address book cards. Newsgroup messages are not indexed.

Reasons for rebuilding the Global Database include:

  • The database may have been corrupted.
  • The search index may not be functioning correctly, such as displaying blank results or performing poorly.
  • The database is too big and needs to be reduced in size.
  • The Global Database file becomes fragmented, which reduces index performance.

Rebuilding the database will not automatically reduce the size of the index.
It will only shrink if there are fewer messages to index since it was last updated, which can be accomplished by deleting messages or disabling message sync for an account or folder.

Steps to rebuild the Global Database:

  1. Quit Thunderbird.
  2. Delete the global-messages-db.sqlite file in the Thunderbird Profile you want to rebuild the index for. 
    rm "${THUNDERBIRD_DATA_DIR}/Profiles/we12yhij.default/global-messages-db.sqlite"
  3. Start Thunderbird.

The re-indexing process will start automatically.
Depending on the number of messages, it might take some time for the indexing to complete; performance might be affected, and the search will return only partial results or even no results until the indexing is complete.

The indexing progress can be monitored through Tools > Activity Manager.

Sources