Skip to content

How to get your Firefox logs

lmarceau edited this page Aug 18, 2023 · 7 revisions

Firefox logs

If you're having an issue in the application, but the application isn't crashing it will be useful to get the Firefox logs. Firefox logs can help pinpoint certain issues although without certainty. If you experience a crash make sure to share the crash log first rather than the Firefox logs.

There are two ways of getting Firefox logs. The first one you only need your phone and the second you need Xcode.

Access Firefox logs via Files App on iOS Device

  • Launch Firefox on a real device.
  • Open Settings.
  • Scroll down to Version and tap it 5 times.
  • Scroll down and hit Copy log files to app container. This triggers the logs to be saved into the Documents folder.
  • Open the Files App on your iOS device and navigate to Browse > On my iPhone > Firefox or Fennec > Logs. You can see the different logs files here, which you can export using the share menu from Apple.

Access Firefox logs via XCode container method

  • Launch Firefox on a real device.
  • Open Settings.
  • Scroll down to Version and tap it several times.
  • Scroll down and hit Copy log files to app container. This triggers the logs to be saved into the Documents folder.
  • Connect your device via USB.
  • Open Xcode.
  • Window > Devices. Choose your device.
  • Find Firefox on the right side.
  • Click the three dots icon, and choose "Download Container…". Save it somewhere you can find later. This saves a .xcappdata file. Screen Shot 2022-10-24 at 1 57 31 PM
  • Locate the .xcappdata file you just saved and right-click on it to "Show Package Contents".
  • Navigate to AppData/Documents/Logs, you have all the devices logs there.

Firefox logs format

App version equal or greater than v111

Logs are into one file only called Firefox.log. Each new application session will be saved inside the same file.

App version less than v111

Logs were separated in three categories:

  • Sync to record what's happening with Sync, Accounts, Providers, Storage, and Profiles called Sync.log
  • Browser to record what's happening in the front-end and the browser Browser.log
  • Keychain to record interactions with the keychain Keychain.log

Each session created a new file, meaning there will be a lot of files in the Documents folder.

Clone this wiki locally