WSL BOINC Image

Preparation of the WSL image for BOINC BUDA

This applies to the https://github.com/BOINC/WSL-DistroLauncher project maintainers only.

WSL 1 doesn't support Docker, so the WSL image should be created for WSL 2 only

1. Download Ubuntu 24.04 LTS from the Microsoft Store
2. Install Ubuntu 24.04 LTS
3. Open Ubuntu 24.04 LTS
4. When prompted to create a new user, create a new user boinc with password boinc
5. Update the system

   sudo apt update -y
   sudo apt upgrade -y

6. Install required packages

   sudo apt install ca-certificates gnupg lsb-release curl -y

7. Install docker

   sudo mkdir -p /etc/apt/keyrings
   sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
   sudo echo \
    "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
    $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
   sudo apt update -y
   sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

8. Setup permissions

   sudo groupadd docker
   sudo usermod -aG docker boinc

9. Cleanup

   sudo apt autoclean -y
   sudo apt clean -y
   sudo apt autoremove -y
   sudo rm -rf /tmp/*
   sudo rm -rf /var/tmp/*
   sudo journalctl --vacuum-size 10M

10. Exit Ubuntu 24.04 LTS and wait until stopped

    wsl.exe --list -v

11. Shutdown WSL if necessary

    wsl.exe --shutdown

12. Export WSL

    wsl.exe --export Ubuntu-24.04 install.tar.gz

13. Archive install.tar.gz into install.tar.gz.7z file using ultra compression and the LZMA2 method
14. Put install.tar.gz.7z into the WSL-DistroLauncher directory