diff --git a/doc/installing-from-source.md b/doc/installing-from-source.md index c67865b..4a2f95c 100644 --- a/doc/installing-from-source.md +++ b/doc/installing-from-source.md @@ -76,3 +76,19 @@ Note though that we can't assist with any issues setting ADB up, _especially not_ on Windows. There have been too many driver issues to make this the "golden path" for most users or contributors. There have been instances where people managed to brick their orbic devices using ADB on Windows. + +## Troubleshooting + +You may need to turn off your VPN in order to load the frontend succesfully - even with local network sharing enabled, VPNs can interfere with the connection to the backend. + +Specifically for WSL users: + +- The HyperV firewall also tends to interfere with the connection between frontend and backend. You can turn it off in your WSL settings. + +- WSL2 has a known compatibility issue which may prevent vite from detecting file system changes and therefore affects HMR (hot module replacement). +If your hot reloading does not work, some have success using polling to detect changes. To do so, specify the following setting in vite.config.ts: +```ts +server: { + watch: { usePolling: true } +} +``` \ No newline at end of file