4.1.5.1 WSL Support

Windows Subsystem for Linux allows the development of OpenCRVS in Windows without having to run VirtualBox or other virtual machines. This page describes some common problems and solutions for them.

Install

For installation of WSL 2 in Windows, refer to Microsoft's documentation.Make sure you're using Visual Studio Code to develop and install the WSL extension for it. Do not install Docker within the WSL Linux distribution. Docker For Desktop will automatically do that for you.Do not install Docker within WSL. Install Docker for Desktop and it will do the integration for you.

Post-install

Usual problems

Only one or few OpenCRVS microservices aren't running

Typically this is because Windows is reserving a specific port but the WSL Linux world doesn't pick that up. For example, if gateway fails to run, you can find in Windows Powershell what process is running in the portPS C:\Users\dev> netstat -ano | findstr :7070TCP 127.0.0.1:7070 0.0.0.0:0 LISTENING 20352​PS C:\Users\dev> tasklist /FI "PID eq 20352"​Image Name PID Session Name Session# Mem Usage========================= ======== ================ =========== ============wslrelay.exe 20352 Console 1 8 512 K

WSL hangs or running out of memory

Running all the databases and Node.js services OpenCRVS uses can demand quite a bit of memory. For WSL, we're suggesting at least 16GB of memory but the amount can vary between computers and WSL installations. It's also recommended you allow WSL use more memory by editing .wslconfig You can do this by pressing Win+R and enternotepad.exe %UserProfile%/.wslconfigInsert this content into the file and save. Don't go above the amount of memory visible in task manager (CTRL + Shift + ESC)[wsl2]memory=16GB

Last updated