Docs

Windows-WSL-Einrichtung

Die ppl-CLI benötigt eine Linux-Umgebung. Unter Windows führst du sie innerhalb von WSL2 (Windows Subsystem for Linux 2) aus, das dir einen echten Linux-Kernel und native Dateisystem-Performance ohne jeglichen Virtualisierungs-Overhead bietet.

Bevor du beginnst

VPN (vorübergehend) deaktivieren

Manche Unternehmens-VPNs blockieren das Internet von WSL, wodurch die CLI-Installation fehlschlägt. Deaktiviere das VPN für die Installation und aktiviere es danach wieder.

Hardware-Virtualisierung aktivieren

WSL2 erfordert Hardware-Virtualisierung. Bei den meisten modernen PCs ist sie standardmäßig aktiviert — überprüfe das unter Task Manager → Performance → CPU → Virtualization.

Wenn dort Enabled steht, ist alles in Ordnung. Falls Disabled:

  1. Starte deinen PC neu und drücke während des Bootvorgangs die BIOS-Taste (Lenovo: F1/F2/Fn+F2, Dell: F2, ASUS: Del/F2).
  2. Suche Virtualization Technology, VT-x oder AMD-V und setze die Option auf Enabled.
  3. Speichern und beenden. Überprüfe nach dem Neustart erneut den Task Manager.

Video: So aktivierst du die Virtualisierung im Lenovo-BIOS. Andere Hersteller haben ähnliche Menüs.

WSL2 mit Ubuntu installieren

Öffne PowerShell als Administrator und führe aus:

wsl --install

Dies installiert WSL2 und standardmäßig Ubuntu. Starte neu, wenn du dazu aufgefordert wirst. Nach dem Neustart schließt Ubuntu die Einrichtung ab und fordert dich auf, einen Benutzernamen und ein Passwort zu wählen — diese sind unabhängig von deinem Windows-Konto.

Ubuntu aktualisieren

Starte Ubuntu über das Start menu und führe aus:

sudo apt update && sudo apt upgrade -y

Die CLI installieren

Innerhalb des Ubuntu-Terminals:

curl -fsSL https://app.pipelogic.ai/api/v1/install | bash

Der Installer lädt die passende Binärdatei für deine Plattform herunter, prüft deren Checksumme und verlinkt ppl per Symlink nach $HOME/.local/bin. Wenn dieses Verzeichnis nicht bereits in deinem PATH liegt, gibt der Installer die genaue Zeile aus, die du für deine Shell hinzufügen musst (zum Beispiel das Anhängen von export PATH="$HOME/.local/bin:$PATH" an ~/.bashrc). Füge sie hinzu und öffne das Terminal anschließend erneut.

Überprüfen

ppl versionppl

Wenn du command not found: ppl siehst, hat deine Shell den neuen PATH nicht übernommen — schließe das Ubuntu-Terminal und öffne es erneut.

Die CLI verwenden

ppl loginppl runtime listppl component list

Für die genaue Befehlssyntax führe ppl <command> --help aus.

Hinweise

  • Der Installationsbefehl muss innerhalb des Ubuntu-(WSL-)Terminals ausgeführt werden, nicht in der Windows-CMD oder PowerShell.
  • Dateipfade innerhalb von WSL sehen aus wie /home/<user>/... — Windows-Pfade (C:\Users\...) funktionieren über /mnt/c/Users/....
  • Komponenten-Builds laufen remote auf der Plattform — innerhalb von WSL werden weder ein lokales Docker noch eine Build-Toolchain benötigt.

War diese Seite hilfreich?