Using windows built in WSL (Windows Subsystem for Linux) we can leverage Windows to run a Linux environment on your Windows machine, without the need of a VM, dual booting etc...
Last updated
Launch NVIDIA GeForce Experience from your Windows System and Select "Drivers" - Install and follow the instructions to make sure you are running the latest driver package. This is optional, but highly recommended.
First we'll want to setup Windows 10/11 so we can use WSL (Windows Subsystem for Linux.) Open a Windows Terminal as Administrator (PowerShell terminal works too) and enter
wsl --install -d Ubuntu-22.04WSL should start the install, follow the prompts and wait for the install to complete.
Reboot your Windows machine if needed - then we can proceed with our Ubuntu configuration. After the reboot Ubuntu should launch on its own to finish the install. If for some reason it doesnt you can start it by going to the Start Menu and Searching for Ubuntu
Once the install finishes, you will be prompted to create a username and password. They don’t need to match your Windows user credentials, just make sure you remember it.
This User Name and Password is specific to each separate Linux distribution that you install and has no bearing on your Windows user name.
Please note that whilst entering the Password, nothing will appear on screen. This is called blind typing. You won't see what you are typing, this is completely normal.
Once you create a User Name and Password, the account will be your default user for the distribution and automatically sign-in on launch.
This account will be considered the Linux administrator, with the ability to run sudo (Super User Do) administrative commands.
Each Linux distribution running on WSL has its own Linux user accounts and passwords. You will have to configure a Linux user account every time you add a distribution, reinstall, or reset.
Finally we'll update the new Ubuntu install by running:
sudo apt update && sudo apt -y upgrade
Let the updates run and say and that's it! You installed Linux on your Windows machine.
Another option is to install Windows Terminal - this will give you a bit better UI experience if you want. It can be found at - https://learn.microsoft.com/en-us/windows/terminal/install
Miner Configuration
Open you WSL by entering the following command via Command Prompt/Windows PowerShellwsl -d Ubuntu-22.04Or simply searching for Ubuntu in your Start Menu
It should load your Linux environment and look something like this:
This should put you in your home directory, this is where we'll install everything. If you run pwd it should list the directory and look like /home/username
pwdIn your Ubuntu Terminal Window paste the following and hit Enter
mkdir -p ~/miniconda3
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda3/miniconda.sh
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
rm -rf ~/miniconda3/miniconda.shNext run the following to initilize conda
~/miniconda3/bin/conda init bashClose your terminal and relaunch Ubuntu (Start Menu > Ubuntu 22.04)
Create a new environment with conda create --name gpu-3-11 python=3.11.
Activate the environment using conda activate gpu-3-11.
You should see your terminal change, now we should be in the gpu-3-11 environment we created
Paste the following into your Terminal and hit Enter
wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2204/x86_64/cuda-ubuntu2204.pin
sudo mv cuda-ubuntu2204.pin /etc/apt/preferences.d/cuda-repository-pin-600
wget https://developer.download.nvidia.com/compute/cuda/12.1.0/local_installers/cuda-repo-ubuntu2204-12-1-local_12.1.0-530.30.02-1_amd64.deb
sudo dpkg -i cuda-repo-ubuntu2204-12-1-local_12.1.0-530.30.02-1_amd64.deb
sudo cp /var/cuda-repo-ubuntu2204-12-1-local/cuda-*-keyring.gpg /usr/share/keyrings/
sudo apt-get update
sudo apt-get -y install cudaPaste the following into your Terminal and hit Enter (this will take a few minutes to install)
conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch -c nvidiaNext we'll download the miner scripts from Heurist - run the following in your terminal
git clone https://github.com/heurist-network/miner-releaseMake sure you're in the Conda environment
conda activate gpu-3-11Navigate to the miner-release directory
cd miner-releaseInstall dependencies with
pip install -r requirements.txt.
Make sure you are in the miner-release directory cd ~/miner-release
create the .env file using the following command (enter your wallet address)
touch .env
echo "MINER_ID_0=(YOUR WALLET HERE)" > .envExecute the miner script with python3 sd-miner-v1.x.x.py (select the latest version) in your terminal. Agree to download model files when prompted. Once the files download the miner should be ready and start. You should see the following to confirm the GPU is processing requests:
TIP - In Linux using the "Tab" key will auto complete your command, so in this case we can type python3 sd-miner then hit the "Tab" key to auto complete the command with the current script version. If you have multiple versions of the script it will display them, make sure to type out the most recent version.
