For Windows 10 users that prefer Linux functionality without the speed sacrifice of a Virtual Machine, Brainlit can be installed and run on WSL2. WSL2 is a fully functional Linux kernel that can run ELF64 binaries on a Windows Host.
- OS Specifications: Version 1903, Build 18362 or higher
- Installation Instructions
- Any Linux distribution can be installed. Ubuntu16.04.3 was used for this tutorial.
Run the below commands to configure the WSL2 environment. See here for more information.
$ sudo apt update && sudo apt install -y build-essential git libexpat1-dev libssl-dev zlib1g-dev
$ libncurses5-dev libbz2-dev liblzma-dev
$ libsqlite3-dev libffi-dev tcl-dev linux-headers-generic libgdbm-dev
$ libreadline-dev tk tk-dev
- Pyenv WSL2 Install (easiest for WSL2)
- Anaconda WSL2 Install
- See installation section of README.md
- See AWS Secrets file section of README.md
Install jupyter notebook: $ python -m pip install jupyter notebook and add the following line to your ~/.bashrc script:
export DISPLAY=`grep -oP "(?<=nameserver ).+" /etc/resolv.conf`:0.0
To launch jupyter notebook, you need to type $ jupyter notebook --allow-root, not just $ jupyter notebook
Then copy and paste one of the URLs outputted into your web browser.
If your browser is unable to connect, try unblocking the default jupyter port via this command: $ sudo ufw allow 8888
- Install VcXsrv Windows X Server on your Windows host machine
- Let VcXsrv through your Public & Private windows firewall. (Control Panel -> System and Security -> Windows Defender Firewall -> Allowed Apps -> Change Settings)
- Run XLaunch on your Windows Host Machine with default settings AND select the "Disable Access Control" option
- To confim X11 Port Forwarding is configured, run
xclockon the subsystem. This should launch on your windows machine.
- The Napari viewer cannot be fully launched (only launches a black screen), because OpenGL versions>1.5 are not currently supported by WSL2. This should be resolved in upcoming WSL2 updates.