📖
Empirica v1 Docs
  • Introduction
  • Getting Started
    • Setup
      • Windows WSL Instructions
    • Creating your experiment
    • Running your experiment
    • Updating your experiment
  • Guides
    • Tutorial: Your First Experiment
      • Part 1: Getting Started
      • Part 2: Configuring the Experiment
      • Part 3: Adding Social Information and New Factors
      • Part 4: Adding Chats
      • Part 5: Adding Bots
    • The Settings File
      • Specifying Login Details
      • Setting player ids via URL queries
      • Connecting Locally to MongoDB
    • The Admin Panel
    • Special Empirica Elements (and how to modify them)
    • Deploying Your Experiment
      • Database
      • Hosting
    • Managing the Data
    • Using Custom Collections
  • Conceptual Overview
    • Structure
    • Game Life Cycle
      • Customising when players submit stages
    • Concepts
    • Randomization & Batches
    • API
  • FAQ
    • I need help!
    • The Processes and Elements of an Empirica Experiment
    • Managing Players and Games
  • Community Demos
    • Guess The Correlation
    • Random Dot Motion
    • Room Assignment
  • Tips & Tricks
    • Helpful Linux Commands
    • Code Editors
  • Links
    • Empirica website
    • Twitter
    • GitHub
Powered by GitBook
On this page
  • Step 1. Install WSL 2 and Ubuntu 20.04
  • Step 2. Install NVM
  • Step 3. Editing Files in WSL2
  • Using code editors

Was this helpful?

  1. Getting Started
  2. Setup

Windows WSL Instructions

PreviousSetupNextCreating your experiment

Last updated 3 years ago

Was this helpful?

Step 1. Install WSL 2 and Ubuntu 20.04

  1. Follow either the written instructions or video tutorial below to install WSL2.

  2. During this process, select "Ubuntu 20.04" as your Linux version.

  3. See our overview below for a summary with screenshots.

Written Instructions: https://docs.microsoft.com/en-us/windows/wsl/install-win10

Video Tutorial: https://www.youtube.com/watch?v=D7Em1wjMiak (commands in the description)

Our Summary of these Instructions:

  1. Enable the Windows Subsystem for Linux

  2. Ensure you meet the requirements for WSL2

  3. Enable the Virtual Machine feature in Windows (see screenshot below)

  4. Download the WSL2 update package

  5. Set WSL2 as your default Linux system

  6. Open Microsoft store, search for Ubuntu 20.04, and install it

  7. Launch the terminal and follow the prompt to create a new username/password (see screenshot below).

Screenshot: Enabling Virtual Machine feature in Windows:

Screenshot: Running Ubuntu 20.04 in Windows for the first time:

Step 2. Install NVM

Note: Copy these commands and then paste into WSL2 by right-clicking on the terminal.

Enter the following commands into your Ubuntu terminal:

curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash  # Download and install
source ~/.profile  # Reload system environment
nvm install lts/erbium

Step 3. Editing Files in WSL2

In order to access your WSL2 file directory, run the following command in WSL2:

explorer.exe .

This will allow you to browse WSL2 as if it were another computer on a local network.

If you are using the WSL, you files for your experiment must be in the WSL, you can't use the WSL to run an experiment stored on the rest of your computer.

Using code editors

Different code editors (such as VSCode) will have commands that you can run to open them in the current directory (e.g., code .). This helps make for a better coding experience in the WSL.