Developing with WSL

If you're using Windows Subsystem for Linux (WSL), there are some quirks to running Electron apps. Since you can run a mostly complete Linux distribution inside it, it justifiably declares itself as Linux when you're inside of it. However, as of February 2021 there is no support for running graphical apps compiled for Linux out of the box. Simply trying to run an Electron app in development that you've installed dependencies in WSL will try and fail to find an X11 server, and thus not launch.
Fortunately, one of the features of WSL is that you can run Windows executables from a WSL terminal seamlessly. The caveat is that you'll need to reinstall Electron in order to pick up the prebuilt binaries for Windows instead of Linux. Inside a WSL terminal, assuming that you've installed Node.js for Linux, you can run:
NPM
Yarn
1
# If node_modules exists already that was installed in WSL:
2
​
3
rm -r node_modules
4
​
5
# then:
6
​
7
npm install --platform=win32
8
​
9
# or:
10
​
11
npm_config_platform=win32 npm install
12
​
Copied!
1
# If node_modules exists already that was installed in WSL:
2
​
3
rm -r node_modules
4
​
5
# then:
6
​
7
npm_config_platform=win32 yarn
Copied!
Then, start the Electron app in development mode as usual via npm start or yarn start (respectively).
For package/make/publish, you'll still need to specify the platform if you want to generate bundles/distributables for Windows.
NPM
Yarn
1
npm run make -- --platform=win32
Copied!
1
yarn make --platform=win32
Copied!
Some of the dependencies of Electron Forge don't quite work with WSL, as they don't detect that they're running in WSL (instead of Linux) and thus tries to run certain tooling provided as Windows executables in... Wine. We are actively working on making the dependent tooling WSL-aware. The workaround is to run package/make/publish outside of WSL.

Next - Advanced

Auto Update

Last modified 10mo ago

Copy link

Edit on GitHub