docs/TROUBLESHOOTING.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

# Troubleshooting

Got an issue with FlightCore? Hopefully one of the steps below will help you resolve it. If not open an [issue on GitHub](https://github.com/R2NorthstarTools/FlightCore/issues/new) or ping `@geckoeidechse` on the Northstar Discord.

## FlightCore won't launch

If you are on Windows and FlightCore won't start but instead shows an error message like this

![webview2 error message windows](assets/flightcore-webview2-windows-error-message.png)

that means that WebView2 is not installed. WebView2 is an embedded browser framework used by FlightCore to display its GUI.

To install it, you can grab the latest version from the Microsoft website: \
https://developer.microsoft.com/en-us/microsoft-edge/webview2/#download-section

![webview2 download screenshot](assets/webview2-download-screenshot.png)

(make sure to select _Evergreen Bootstrapper_ -> _Download_).


## Linux

### FlightCore launches, but the main window is blank
This may be caused by tauri-apps/tauri#5143

Try setting this environment variable when starting FlightCore:
`WEBKIT_DISABLE_COMPOSITING_MODE=1`

```bash
WEBKIT_DISABLE_COMPOSITING_MODE=1 ./flight-core.AppImage 
```