Skip to main content

Collecting Debug Information

"Desktop App"​

The Electron stores it's cache in these folders:

Windows:

C:\Users\<user>\AppData\Roaming\starsky\logs

Linux:

~/.config/starsky/logs

OS X:

~/Library/Application\ Support/starsky/logs

"Browser"​

If you have a frontend issue, it is often helpful to check the browser console for errors and warnings. A console is available in all modern browsers and can be activated via keyboard shortcuts or the browser menu.

Problems with the user interface can be caused by a bug or an incompatible browser: Some features may not be supported by non-standard browsers, as well as nightly, unofficial, or outdated versions.

In case you don't see any log messages, try reloading the page, as the problem may occur while the page is loading.

Chrome, Chromium, and Edge

  • press ⌘+Option+J (Mac) or Ctrl+Shift+J (Windows, Linux, Chrome OS) to go directly to the Developer Tools
  • or, navigate to More tools > Developer tools in the browser menu and open the Console tab

Firefox

  • press ⌘+Option+K (Mac) or Ctrl+Shift+K (Windows) to go directly to the Firefox Web Console panel
  • or, navigate to Web Development > Web Console in the menu and open the Console panel

Safari

Before you can access the console in Safari, you first need to enable the Develop menu:

  1. Choose Safari Menu > Preferences and select the Advanced Tab
  2. Select "Show Develop menu in menu bar"

Once the Develop menu is enabled:

  • press Option+⌘+C to go directly to the Javascript Console
  • or, navigate to Develop > Show Javascript Console in the browser menu

"Docker Logs"​

Run this command to display the last 100 log messages (omit --tail=100 to see all):

docker compose logs --tail=100

To enable debug mode, set app__verbose to true in the environment: section of the starsky service (or use the -v flag when running the starsky command directly):

services:
    starsky:
    environment:
        app__verbose: "true"

Then restart all services for the changes to take effect. It can be helpful to keep Docker running in the foreground while debugging so that log messages are displayed directly. To do this, omit the -d parameter when restarting:

docker compose stop
docker compose up

Note
If you see no errors or no logs at all, you may have started the server on a different host and/or port. There could also be an issue with your browser, browser plugins, firewall settings, or other tools you may have installed.

TL;DR
The default Docker Compose config filename is docker-compose.yml. For simplicity, it doesn't need to be specified when running the docker-compose command in the same directory. Config files for other apps or instances should be placed in separate folders.