Setup Windows

Manual configuration

Visual Studio Code

Install Visual Studio Code as it comes with useful WSL integrations.

Download Visual Studio Code Stable User Installer for Windows x64.

Terminus

Install Terminus terminal to make your Linux experience smoother.

Download Terminus v1.0.87 installer for Windows.

Windows Subsystem for Linux

Read the official Installation Guide for Windows 10 for enabling the feature.

Automated configuration

Download windows-machine code to your local machine and follow steps to install the dependencies.

Start PowerShell with Run as administrator option to run the following commands.

Install dependencies

Install dependencies as listed in the windows-machine repository.

Enable WinRM

Start Windows Remote Management (WinRM) service and perform configuration actions to enable this machine for remote management:

winrm quickconfig

This will make changes to your firewall to allow remote access, so make sure your Windows machine is located in a secure network.

Execution policy for the PowerShell scripts

Change machine level PowerShell ExecutionPolicy to RemoteSigned in the LocalMachine scope:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine

This will allow the PowerShell scripts to run on your machine. You can revert this policy afterwards.

Chocolatey

Install Chocolatey package manager:

Unblock-File .\Base.ps1
.\Base.ps1

Ubuntu on WSL

Install minimum development environment for running Ubuntu on WSL with the following commands:

Unblock-File .\Minimum.ps1
.\Minimum.ps1

Troubleshooting

You'll need to follow the additional steps in the repository and reboot your machine a few times to get everything working.

See Troubleshooting for common issues during the configuration.