Skip to content

Latest commit

 

History

History
20 lines (16 loc) · 1.33 KB

windows.md

File metadata and controls

20 lines (16 loc) · 1.33 KB
Raw

Using ssdev on Windows

Using ssdev on Windows system is best achieved using WSL. Please follow the steps below to achieve a performant development experience. Also, we recommend VSCode, as it comes with an extension for WSL.

  1. Set up WSL and install a distro (instructions by Microsoft)
  2. Open a Terminal in your WSL Distro and install Node & npm (& npx) (instructions by Microsoft)
  3. install the WSL-extension in VSCode
  4. Install Docker for Desktop
  5. install ssdev inside the WSL environment

The best approach is treating the WSL distro as a remote server and using it to develop your projects. This means that it is best practice to use git inside the distro. You can open any project in VSCode by typing code . in the respective directory.

Known Issue with Docker: ssdev uses bind mounts for the host data (the web directory), but it seems like there is a problem remounting these mounts after a restart of your computer. The quickfix is rather simple: delete the <project>_host_data volume using the GUI or the docker command in WSL. After that, ssdev up will work correctly again.