Skip to main content

Debug Logs and Crash Reports

We want our messaging and calling features to work seamlessly at all times. Thanks for reaching out to us about the issues you’re experiencing and being willing to provide information that will help us troubleshoot the problem.

We take bug reports seriously and appreciate your help in making our applications more stable and usable! If you experience an issue or crash, please submit a debug log immediately after the issue occurs. Sometimes we will also need the debug log from your contact or from both your phone and Signal Desktop.

Follow these steps to share a debug log:

What's in a debug log?

Debug logs contain low level app information and do not reveal any of your message contents. Since we do not collect data on you, we appreciate your help in identifying the issue and working with us to get this resolved.

Android

Steps to share a debug log from Signal when it is unlocked:

  1. In Signal, tap your profile profile_avatar.png > Help > Debug log > Submit.
  2. Tap and hold to copy the URL.
  3. Paste the URL into a new issue form.

Steps to share a debug log from Signal's lock screen:

  1. Go to Menu > Debug log > Submit.
  2. Tap and hold to copy the URL.
  3. Paste the URL into a a new issue form.

Steps to share a debug log from Signal's registration or PIN flow:

Select Contact Support from the screen or follow steps below.

  1. Tap 8x on the header of any screen.
  2. Tap and hold to copy the URL.
  3. Paste the URL into a new issue form.

Please include a Signal Desktop debug log if this is also an issue with Signal Desktop.

 

iOS

Steps to share a debug log

  1. In Signal, tap your profile profile_avatar.png > Settings > Help > Submit Debug Log > Copy Link.
  2. Send the email with a description of what is going on.

Steps to share a debug log from Signal's registration or PIN flow:

Select Contact Support from the screen or follow steps below.

  1. Tap 8x on an empty space on the screen.
  2. Tap and hold to copy the URL.
  3. Paste the URL into a new issue form.

Steps to share a crash report

  1. Go to iOS Settings iOSSettings.png > Privacy (& Security) > Analytics (& Improvements) > Analytics Data.
  2. Locate and select the latest Signal-(DateTime).ips file. Make sure the file starts with Signal, ignore any file that includes wakeups, and make sure it includes the most recent date and time.
  3. Tap Share iOS_Share_Action.png in the top right.
  4. Send the email to support@signal.org.

Please include a Signal Desktop debug log if this is also issue with Signal Desktop.

 

Desktop

Steps to share a debug log

  1. Open Signal > View > Debug Log.
  2. Examine or edit your Debug log.
  3. Choose Submit.
  4. Select Copy Link.
  5. Paste the URL into a a new issue form.
  6. Select desktop_close_circle.png Close in the top-right to go back to your conversations.

Steps to share a debug log if Signal Desktop does not open

  1. Find the folder with your application data
    • macOS: ~/Library/Application Support/Signal
    • Linux: ~/.config/Signal
    • Windows: C:\Users\<YourUserName>\AppData\Roaming\Signal
  2. Optional: ZIP/Compress the logs folder
  3. Share the logs folder or a specific log from within the logs folder as an attachment to support@signal.org.

Please include a Signal Android debug log or Signal iOS debug log if this is an issue involving your mobile.

Related articles