Debug

It could happen that you stumble upon a fatal error in the app (or dashboard).

In order to help us isolate the issue and fix it, please follow the instructions below.

Modal

Most of the time, when an error occurs, you will see a fatal screen that resembles the one below:

image

What is important to us is actually the red message that you will find below this screen; see below:

image

Logs

Even though this error message is valuable to us to fix the issue, it would be even better if you could provide us with the developer logs leading to the error.

When in the app, you can display the developer logs in the Javascript console by pressing CMD+ALT+i on macOS (alternatively CTRL+SHIFT+j on Windows).

It should look something like that:

image

You should see a red error message at the end of the logs. If you don’t see anything, try scrolling up until you see something suspicious.

Please share those logs (in a private message on Discord/Slack or through email support@routine.co if you feel those are sensitive) with details of the operation you performed which led to the error.

💡
Note that the red messages Refused to set unsafe header "Content-Length" can be safely ignored, those are not fatal errors.

🙏

Problems updating the desktop application

Besides the Modal and Logs logs, there is more information you can provide us if the application is having trouble updating, for example if it can’t update to a new version, or crashes immediately after an update.

Finding update logs

On macOS

Update logs can be found in:

~/Library/Caches/co.routine.desktop.ShipIt/ShipIt_stderr.log
~/Library/Caches/co.routine.desktop.ShipIt/ShipIt_stdout.log

On Windows

%LOCALAPPDATA%\Routine\SquirrelSetup.log

You can access this by:

  1. Press Windows + R
  2. Type %LOCALAPPDATA%\Routine
  3. Look for SquirrelSetup.log

On Linux

We don’t support auto updating on Linux at the moment.

What to look for

These logs contain important information about the update process, including:

  • Download attempts and completion status
  • Installation steps and any failures
  • Permission or file access issues
  • Verification of downloaded files
  • Code signing verification results

Key error messages often start with:

  • "Installation error:"
  • "Download failed:"
  • "Error Domain="
  • "Permission denied"
  • "Update failed:"

Please share those logs (in a private message on Discord/Slack or through email support@routine.co if you feel those are sensitive) with details of the operation you performed which led to the error.