> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Bekannte Probleme mit WSL
> Beheben Sie bekannte Probleme mit Devin Desktop bei der Ausführung unter Windows Subsystem for Linux (WSL), darunter Leistungseinbußen durch Überlastung des Plan-9-(9P)-Dateisystems und Verbindungsfehler, die durch VPN- oder Zero-Trust-Netzwerksoftware verursacht werden.
Diese Seite beschreibt bekannte Probleme bei der Verwendung von Devin Desktop mit Windows Subsystem for Linux (WSL) sowie die empfohlenen Korrekturen.
***
## **Leistungsprobleme oder Verbindungsabbrüche (Überlastung des 9P-Dateisystems)**
Bei der Verwendung von Devin Desktop in WSL (über **Remote - WSL**) kann der Editor langsam werden, nicht mehr reagieren oder wiederholt die Verbindung zum WSL-Backend verlieren. Die häufigste Ursache sind Erweiterungen, die das WSL-Dateisystem durch aggressives Überwachen von Dateien und Indizierung stark belasten und dadurch das **Plan 9 (9P)-Protokoll** auslasten – die Dateisystembrücke zwischen Windows und der WSL-Linux-Umgebung.
Das tritt besonders häufig bei großen Repositorys auf und wenn mehrere Language Server gleichzeitig laufen.
### **Symptome**
* Devin Desktop ist bei der Verbindung mit WSL merklich langsam oder reagiert verzögert
* Der Editor verliert häufig die Verbindung zum WSL-Backend und versucht, sie wiederherzustellen
* Verbindungsabbrüche treten sowohl während der aktiven Entwicklung (z. B. bei der Verwendung von Cascade) **als auch** im Leerlauf des Editors auf
* Devin Desktop stürzt ab oder reagiert nicht mehr, sodass sowohl die IDE als auch WSL neu gestartet werden müssen (`wsl --shutdown`)
* Die Speichernutzung von WSL steigt mit der Zeit an, selbst auf Systemen mit 32 GB+ RAM
* WSL-Diagnoseprotokolle zeigen eine große Anzahl von `P9 Reply_Rlerror`-Ereignissen (Datei nicht gefunden)
* Die Leistung ist normal, wenn Devin Desktop außerhalb von WSL verwendet wird (z. B. beim Öffnen eines lokalen Windows-Ordners)
* Gängige Behelfslösungen (Neustart von WSL, Neuinstallation von Devin Desktop, Erhöhen des Speichers in `.wslconfig`) beheben das Problem nicht zuverlässig
***
### **Grundursache**
Die Kommunikation zwischen Windows und dem WSL-Linux-Dateisystem erfolgt über das **Plan 9 (9P)-Protokoll**, das im Vergleich zum nativen Dateisystemzugriff nur einen begrenzten Durchsatz bietet.
Wenn Erweiterungen in der WSL-Umgebung installiert sind, überwachen und indexieren manche aggressiv Dateien im gesamten Workspace. In großen Repositorys (z. B. 250.000+ Dateien, 5+ GB) erzeugt das ein enormes Volumen an Dateisystemoperationen über die 9P-Bridge, was zu Folgendem führen kann:
* Die Kapazität des Protokolls ausreizen
* Tausende Datei-nicht-gefunden-Fehler (`Reply_Rlerror`) verursachen
* Die Verbindung zwischen Devin Desktop und dem WSL-Backend zum Abbruch bringen
* Mit der Zeit den Speicherdruck innerhalb von WSL erhöhen
Das verschärft sich zusätzlich, wenn mehrere Language Server laufen (z. B. Sorbet, Ruby LSP, TypeScript usw.), da sie weiteren Overhead durch Dateiüberwachung verursachen. Die kombinierte Dateisystemaktivität von Erweiterungen und Language Servern kann die 9P-Bridge selbst auf Systemen mit 32 GB+ RAM überlasten.
Ein bekanntes Beispiel ist die **Vue (Volar)-Erweiterung**, bei der beobachtet wurde, dass sie in WSL-Umgebungen übermäßige Dateiindexierung verursacht, selbst wenn der Workspace keine Vue-Dateien enthält. Dieses Problem ist im VS Code-Ökosystem dokumentiert:
[microsoft/vscode-remote-release#11091](https://github.com/microsoft/vscode-remote-release/issues/11091)
Das ist besonders wahrscheinlich, wenn Sie eine große Anzahl von Erweiterungen aus VS Code oder einem anderen Editor übernommen haben, die für Ihr aktuelles Projekt nicht benötigt werden.
***
### **Lösungen**
#### **1. WSL auf die neueste Version aktualisieren (empfohlener erster Schritt)**
Viele Verbindungsabbrüche und Leistungsprobleme in WSL lassen sich oft schon beheben, indem Sie einfach WSL selbst aktualisieren. Neuere WSL-Versionen enthalten Verbesserungen bei der Stabilität des 9P-Dateisystems und der Zuverlässigkeit von Verbindungen.
Öffnen Sie **PowerShell** (oder die Eingabeaufforderung) auf Ihrem Windows-Host und führen Sie Folgendes aus:
```
wsl --update
```
Starten Sie anschließend WSL neu:
```
wsl --shutdown
```
Öffnen Sie Devin Desktop erneut und stellen Sie die Verbindung zu WSL wieder her. Ihre WSL-Version können Sie mit Folgendem überprüfen:
```
wsl --version
```
WSL **ab 2.7.3.0** enthält Korrekturen, die anhaltende Verbindungsabbrüche für Nutzer auch ohne weitere Konfigurationsänderungen beheben.
***
#### **2. Saubere Neuinstallation des Devin Desktop-Servers in WSL**
Löschen Sie das Verzeichnis des Devin Desktop-Servers in WSL, damit Devin Desktop es bei der nächsten Verbindung neu installiert:
```shell theme={null}
rm -rf ~/.windsurf-server
```
Verbinden Sie dann Devin Desktop erneut mit WSL. Der Server wird automatisch neu installiert.
***
#### **3. Installierte Erweiterungen minimieren (größter Einfluss)**
Installieren Sie nur Erweiterungen, die Sie für das Repo, in dem Sie arbeiten, tatsächlich benötigen.
* Öffnen Sie in Devin Desktop bei bestehender WSL-Verbindung den Bereich „Erweiterungen“
* Prüfen Sie, welche Erweiterungen in der **WSL**-Umgebung installiert sind (nicht nur lokal)
* Deaktivieren oder deinstallieren Sie Erweiterungen, die Sie nicht benötigen – insbesondere solche, die intensive Dateiüberwachung oder Indexierung durchführen
**Bekanntermaßen problematische Erweiterungen in WSL:**
* **Vue (Volar)** — verursacht nachweislich übermäßige Dateiindexierung über die 9P-Bridge, selbst in Nicht-Vue-Projekten. Allein die Deinstallation dieser Erweiterung hat bei mehreren Nutzern Verbindungsabbrüche behoben.
* Andere frameworkspezifische Spracherweiterungen (Angular, Svelte usw.) können sich ähnlich verhalten, wenn sie installiert sind, aber für den aktuellen Workspace nicht benötigt werden.
Gehen Sie **nicht** davon aus, dass Erweiterungen, die in einem lokalen Setup (ohne WSL) problemlos funktionieren, sich in WSL genauso verhalten. Die 9P-Dateisystem-Bridge ist der Engpass – Erweiterungen, die lokal unproblematisch sind, können instabil machen, wenn jeder Dateivorgang die Protokollgrenze überschreiten muss.
Weniger durch Erweiterungen verursachte Dateisystemaktivität reduziert direkt die Last auf der 9P-Bridge.
***
#### **4. WSL-Ressourcenlimits optimieren**
Erstellen oder bearbeiten Sie die Datei `%USERPROFILE%\.wslconfig` auf Ihrem **Windows**-Host (z. B. `C:\Users\\.wslconfig`) und legen Sie Ressourcenlimits fest, die für Ihr System geeignet sind:
```
[wsl2]
memory=16GB
swap=4GB
processors=4
autoMemoryReclaim=gradual
```
> **Hinweis:** Die Einstellung `autoMemoryReclaim` wurde in WSL **2.7.3.0** und später entfernt. Wenn Sie WSL 2.7.3.0+ verwenden, lassen Sie diese Zeile weg. Sie können Ihre WSL-Version mit `wsl --version` überprüfen.
Passen Sie die Werte an die auf Ihrem System verfügbaren Ressourcen an.
Nachdem Sie die Datei gespeichert haben, starten Sie WSL neu:
```
wsl --shutdown
```
Öffnen Sie dann Devin Desktop erneut und stellen Sie die Verbindung zu WSL wieder her.
***
### **Fehlerdiagnose**
#### **WSL-Diagnoseprotokolle auf 9P-Fehler überprüfen**
Um zu bestätigen, dass die Ursache in einer 9P-Sättigung liegt, sammeln Sie WSL-Diagnoseprotokolle:
```
wsl --debug-shell
```
Oder erstellen Sie ein vollständiges Diagnosepaket:
```
Invoke-WebRequest -UseBasicParsing "https://aka.ms/wsldiag" -OutFile wsldiag.ps1
.\wsldiag.ps1
```
Achten Sie in den 9P-/Dateisystemprotokollen auf eine hohe Anzahl von `Reply_Rlerror`-Ereignissen. Tausende oder mehr deuten in der Regel darauf hin, dass Erweiterungen oder Prozesse innerhalb von WSL übermäßig viele Dateisystemanfragen erzeugen, mit denen die 9P-Bridge nicht Schritt halten kann.
***
### **Wann welche Maßnahme sinnvoll ist**
* **WSL zuerst aktualisieren** – viele Probleme lassen sich schon durch `wsl --update` beheben. WSL 2.7.3.0+ enthält erhebliche Stabilitätsverbesserungen. (Einfachste Lösung.)
* **Erweiterungen minimieren**, wenn in WSL viele Erweiterungen installiert sind, die Sie nicht aktiv benötigen, oder wenn Sie Erweiterungen aus einem anderen Editor migriert haben. (Änderung mit der größten Wirkung.)
* **Server sauber neu installieren**, wenn der Serverstatus von Devin Desktop beschädigt oder veraltet sein könnte (z. B. nach einem fehlgeschlagenen Update oder einem früheren Absturz).
* **`.wslconfig` optimieren**, wenn WSL übermäßig viele Host-Ressourcen verbraucht oder wenn Sie bisher keine Ressourcenlimits konfiguriert haben. (Allgemeine Verbesserung der WSL-Stabilität.)
Für optimale Ergebnisse aktualisieren Sie zuerst WSL und wenden Sie die übrigen Maßnahmen dann bei Bedarf an. Die Kombination aus einer aktuellen WSL-Version, einem sauberen Server, wenigen Erweiterungen und abgestimmten Ressourcenlimits behebt sowohl die Grundursache (9P-Sättigung durch Erweiterungsaktivität) als auch begünstigende Faktoren (Ressourcenerschöpfung).
***
## **Keine Verbindung zu WSL bei Verwendung von VPN- oder Zero-Trust-Software**
Devin Desktop kann keine Verbindung zu WSL herstellen und zeigt den Fehler `Couldn't install vscode server on remote server, install script returned non-zero exit status` an, wenn VPN- oder Zero-Trust-Software (Twingate, Tailscale, Zscaler, Cloudflare WARP, GlobalProtect usw.) den ausgehenden Netzwerkverkehr innerhalb von WSL blockiert.
### **Symptome**
* Devin Desktop meldet beim Herstellen einer Verbindung mit WSL `Error resolving authority` / `install script returned non-zero exit status`
* WSL selbst funktioniert (`wsl -d Ubuntu -- echo hello` ist erfolgreich), aber `curl` läuft innerhalb von WSL in einen Timeout
* Das Problem trat auf, nachdem VPN- oder Zero-Trust-Software installiert oder aktualisiert wurde
### **Ursache**
WSL 2 leitet den Datenverkehr standardmäßig über ein NAT-basiertes virtuelles Netzwerk. VPN- und Zero-Trust-Software leitet den Datenverkehr aus diesem virtuellen Netzwerk häufig nicht weiter, sodass der Download des Devin-Desktop-Servers unbemerkt fehlschlägt.
### **Lösung**
#### **1. Gespiegeltes Netzwerk aktivieren**
Bearbeiten Sie die WSL-Konfigurationsdatei, um gespiegeltes Netzwerk zu aktivieren (normalerweise `C:\Users\\.wslconfig`).
Fügen Sie Folgendes hinzu:
```ini theme={null}
[wsl2]
networkingMode=mirrored
dnsTunneling=true
autoProxy=true
```
Starten Sie dann WSL neu und bereinigen Sie alle veralteten Installationsreste:
```
wsl --shutdown
wsl -d Ubuntu -- bash -c "rm -f ~/.windsurf-server/.installation_lock"
```
Öffnen Sie Devin Desktop erneut und verbinden Sie es wieder mit WSL. Der Server wird automatisch installiert.
> **Hinweis:** Erfordert WSL 2.0.0 oder höher. Führen Sie `wsl --version` aus, um dies zu überprüfen, und `wsl --update`, um bei Bedarf ein Update durchzuführen.
#### **2. Alternative: VPN vorübergehend trennen**
Wenn Sie `.wslconfig` nicht ändern können, trennen Sie vorübergehend die VPN-/ZTNA-Verbindung, lassen Sie Devin Desktop den Server installieren und verbinden Sie sich dann wieder. Für künftige Updates von Devin Desktop ist aus WSL erneut Netzwerkzugriff erforderlich.