Windows (WSL)

Nutze Matrix unter Windows am besten mit WSL.

Matrix laeuft zwar direkt unter Windows, die beste Erfahrung bekommst du aber mit Windows Subsystem for Linux (WSL). WSL bietet eine Linux-Umgebung, die mit den Matrix-Features nahtlos funktioniert.

Einrichtung

Install WSL

Falls noch nicht geschehen, installiere WSL mit der offiziellen Microsoft-Anleitung.
Install Matrix in WSL

Wenn WSL eingerichtet ist, oeffne dein WSL-Terminal und installiere Matrix mit einer der Installationsmethoden.
Terminal-Fenster
```
curl -fsSL https://y-square-t3.github.io/matrix/install | bash
```
Matrix über WSL verwenden

Wechsle in dein Projektverzeichnis (Windows-Dateien erreichst du ueber /mnt/c/, /mnt/d/ usw.) und starte Matrix.
Terminal-Fenster
```
cd /mnt/c/Users/YourName/project
matrix
```

Desktop-App + WSL-Server

Wenn du die Matrix-Desktop-App nutzen willst, den Server aber in WSL betreiben moechtest:

Starte den Server in WSL mit --hostname 0.0.0.0, damit externe Verbindungen moeglich sind:
Terminal-Fenster
```
matrix serve --hostname 0.0.0.0 --port 4096
```
Verbinde die Desktop-App mit http://localhost:4096

Web-Client + WSL

Fuer die beste Web-Erfahrung unter Windows:

Fuehre matrix web im WSL-Terminal aus, nicht in PowerShell:
Terminal-Fenster
```
matrix web --hostname 0.0.0.0
```
Rufe die URL im Windows-Browser auf unter http://localhost:<port> (Matrix zeigt die URL an)

Wenn du matrix web aus WSL startest, bleiben Dateizugriff und Terminal-Integration sauber. Gleichzeitig ist die Weboberflaeche weiterhin im Windows-Browser erreichbar.

Zugriff auf Windows-Dateien

WSL kann ueber das Verzeichnis /mnt/ auf alle Windows-Dateien zugreifen:

Laufwerk C: -> /mnt/c/
Laufwerk D: -> /mnt/d/
usw.

Beispiel:

cd /mnt/c/Users/YourName/Documents/project
matrix

Tipps

Lass Matrix in WSL laufen, auch wenn das Projekt auf einem Windows-Laufwerk liegt
Nutze die WSL-Extension von VS Code fuer einen integrierten Workflow
Matrix-Konfiguration und Sitzungen liegen in WSL unter ~/.local/share/matrix/