The following article should provide general guidelines and best practices for troubleshooting Island Browser crash and freeze issues. Many of these issues will require the support of an Island engineer. Data collection is a very important step in the diagnosis and resolution of a browser crash or freeze.

It is always advised to make sure the Island browser version is updated to the most recent version

When working with an end-user who is experiencing a browser crash or freeze issue, it’s important to check if the crash replicates constantly. If it does, take note of the detailed steps that led to the crash.

Data collection:

1. Crash incidents are reported to Island, only after browser restart. Make sure the impacted machine had the Island browser restarted after the crash incident.

2. Check island://crashes, and if there's a pending event that wasn’t uploaded - process the upload.

If for any reason the crash report is not able to upload, locate, and share the logs as they are saved locally with the Expert Sucess team.

Windows: %localappdata%\Island\Island\User Data\Crashpad\reports

MacOS: ~/Library/Application\ Support/Island/Crashpad

If the crash happens on the browser load, launch with the following flag through the terminal:

/Applications/Island.app/Contents/MacOS/Island --trace-startup --trace-startup-file=$HOME/Desktop/load-trace.json --trace-startup-duration=25

Reproduce the crash, and share the load-trace.json with the Expert Success team.