DAMASK installation on Windows Subsystem for Linux (WSL)

[eisenlohr]

DAMASK on Windows

Installing Windows Subsystem for Linux (Ubuntu)

Quick method (Windows 11 or Windows 10 ≥ 2021H2)

Open PowerShell (as Administrator) and run:

wsl --install

This will:

• Enable the WSL feature and the Virtual Machine Platform
• Install the default Linux distribution (Ubuntu)
• Set WSL version 2 as default

After the system reboots, WSL will start Ubuntu and ask you to set a username/password.

Manual method (if wsl --install is not available)

1. Enable WSL feature

   dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

2. Enable Virtual Machine Platform

   dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

3. Reboot your PC

4. Set WSL 2 as default (optional but recommended)

   wsl --set-default-version 2

5. Install a Linux distribution
   Go to the Microsoft Store, search for Ubuntu (or Debian, Kali, etc.), and install it.
   Alternatively:

   wsl --install -d Ubuntu-22.04

💡 Check installation

wsl --list --verbose

Opening Ubuntu and installing a virtual environment

• Open the Ubuntu app

• Enter the following commands:

  sudo apt update
  sudo apt upgrade
  python3 --version
  sudo apt install python3.12-venv

  ⚠️ Make sure the installed Python version matches the Ubuntu version you're using.

Setting up a new environment

• Enter the following commands:

  python3 -m venv damask-venv
  source damask-venv/bin/activate

  📝 damask-venv is just a name — you can change it to anything you prefer.

Install DAMASK within the virtual environment

• Enter the following commands:

  sudo add-apt-repository ppa:damask-multiphysics/ppa
  sudo apt update
  sudo apt-get install -y damask      # DAMASK solver
  pip install damask                  # DAMASK pre- and post-processing tools

Check for proper installation

• To check whether the DAMASK grid solver is correctly installed, enter the command:

  which DAMASK_grid

Accessing Ubuntu files from Windows

• Go to Home in Windows Explorer

• Enter the following path in the address bar:

  \\wsl$
  

• Open the Ubuntu Filesystem