Windows Subsystem for Linux (WSL) Guide

This tutorial guides you through setting up Windows Subsystem for Linux (WSL) to run vBase samples.

1. Install Windows Subsystem for Linux (WSL)

  1. Open PowerShell as Administrator: Right-click the Start button and select “Windows PowerShell (Admin)”.

  2. Enable WSL: Type the following command into PowerShell and press Enter:

    dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
  3. Enable VirtualMachinePlatform Feature: Type the following command into PowerShell and press Enter:

    dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  4. Restart your PC.

  5. Download and Install a Linux Distribution: Go to the Microsoft Store, search for the Ubuntu Linux distribution, and install it.

  6. Set WSL 2 as your default version: Open PowerShell as Administrator again and run:

    wsl --set-default-version 2
  7. Launch WSL: After installation, launch WSL from the Start menu. The first launch will take some time due to setup. You will be prompted to create a user account and password.

2. Install Jupyter Lab

Note: The following steps assume you have WSL installed and are running commands in the open WSL console window.

  1. Update and Upgrade Packages: Update your Linux package list and upgrade the packages by running:

    sudo apt update && sudo apt upgrade -y
  2. Install Python3 and pip: Run the following command:

    sudo apt install python3 python3-pip -y
  3. Install Jupyter Lab: Use pip to install Jupyter Lab:

    pip3 install jupyterlab

3. Install Git

  1. Install Git: Run the following command to install git:

    sudo apt install git -y

4. Clone the vbase-py-samples Git Repository

  1. Create the vBase directory: Create the directory where you want to clone vBase repositories and switch to this directory by running:

    mkdir ~/validityBase && cd ~/validityBase
  2. Clone the Repository: Once you are in the directory where you want to clone the repository, run:

    git clone

5. Run Jupyter Lab and Open a Notebook

  1. Navigate to the Repository Directory:

    cd vbase-py-samples
  2. Run Jupyter Lab: Start Jupyter Lab by running:

    jupyter lab

    This command will start Jupyter Lab and provide you with a URL (including a security access token) to access it from your browser.

  3. Access Jupyter Lab: Copy the provided URL and paste it into your browser's address bar to access Jupyter Lab.

  4. Open a Notebook: In Jupyter Lab, navigate through the file explorer to find the notebook you wish to open in the ~/validityBase/vbase-py-samples/samples folder. Click on it to open and interact with the notebook.

Last updated