Zum Hauptinhalt springen

WSL2

WSL2
Windows Subsystem for Linux ermöglicht es, Linux-Tools und -Anwendungen direkt auf dem Windows-System auszuführen, ohne eine separate virtuelle Maschine oder Dual-Boot-Konfiguration einrichten zu müssen.

Installation WSL2​

  1. Öffnen Sie PowerShell als Administrator:in

  2. Geben Sie den folgenden Befehl ein und drücken Sie Enter, um WSL zu installieren:

    wsl --install

    Troubleshooting

  3. Starten Sie Ihren Computer neu, wenn Sie dazu aufgefordert werden.

  4. Ubuntu installieren: Öffnen Sie PowerShell erneut als Administrator:in und geben Sie den folgenden Befehl ein:

    wsl --install ubuntu

  5. Ubuntu erstmalig starten: Benutzer:in und Passwort festlegen:

    • Benutzername: z.B. Ihr Vorname - ohne Sonderzeichen oder Umlaute
    • Passwort: darf etwas einfaches sein (1234 oder asdf), da für den Zugriff auf WSL zuerst das Windows-Passwort verwendet wird.

    Falls Sie gefragt werden, ob Sie Nutzungsdaten an Ubuntu senden möchtem, können Sie dies mit y annehmen, oder mit n ablehnen.

  6. Aktuelle Ubuntu-Version prüfen:

    Öffnen Sie das Terminal und öffnen Sie darin das Ubuntu-Terminal:

    (Bei älteren Windows-Versionen kann es sein, dass das Terminal nicht installiert ist. Installieren Sie es von 👉 hier)

    und überprüfen Sie die aktuelle Ubuntu-Version mit folgendem Befehl:

    lsb_release -a
    Farbschema anpassen

    Standardmässig verwendet Ubuntu ein violettes Terminal. Damit das Terminal genau gleich aussieht wie oben im Screenshot, kann das Farbschema angepasst werden.

    Anleitung

    Optional: Ubuntu-Terminal als Standard-Terminal festlegen

  7. Ubuntu aktualisieren:

    sudo apt update
    sudo apt upgrade

Installation NVM/NodeJS​

Für eine reibungslose und zukunfssichere Nutzung von NodeJS, wird NVM (Node Version Manager) empfohlen. NVM ermöglicht es, mehrere NodeJS-Versionen auf demselben System zu installieren und zu verwalten.

NVM
👉 Webseite NVM
👉 Installationsanleitung

  1. NVM herunterladen und installieren:

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
    source ~/.bashrc
    nvm -v # 0.39.3

  2. NodeJS installieren:

    nvm install 24.18.0
    nvm use 24.18.0 # Version v24.18.0 verwenden
    nvm alias default 24.18.0 # v24.18.0 als Standardversion festlegen
    node -v # v24.18.0

  3. Paketmanager yarn installieren:

    npm install -g yarn

Docker in WSL installieren​

Für die unkompliziertere Entwicklung der tdev-API wird das Arbeiten mit dev-containern empfohlen. Dazu wird eine Docker-Installation benötigt. Docker-Desktop für Windows ist zwar die Standard-Option, ist aber unglaublich langsam und deshalb nicht empfohlen. Stattdessen kann das Docker-CLI direkt in WSL installiert werden. Die Installation ist unkompliziert und die Performance ist deutlich besser.

  1. Docker Repository hinzufügen: 
    sudo apt install ca-certificates curl
    sudo install -m 0755 -d /etc/apt/keyrings
    sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
    sudo chmod a+r /etc/apt/keyrings/docker.asc

    # Add the repository to Apt sources:
    sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
    Types: deb
    URIs: https://download.docker.com/linux/ubuntu
    Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
    Components: stable
    Architectures: $(dpkg --print-architecture)
    Signed-By: /etc/apt/keyrings/docker.asc
    EOF

    sudo apt update
  2. Docker CLI installieren: 
    sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  3. Docker-Dienst status prüfen/starten: 
    sudo service docker status
    sudo service docker start
    sudo service docker enable
    und Docker zur Nutzung ohne sudo freigeben: 
    sudo groupadd docker
    sudo usermod -aG docker $USER
  4. Laptop neu starten
    (theoretisch reicht auch WSL komplett neu zu starten mit PS wsl --shutdown)
  5. Docker Installation prüfen: 
    docker --version
    docker run hello-world