Windows (WSL)

Esegui Matrix su Windows con WSL per la migliore esperienza.

Anche se Matrix puo essere eseguito direttamente su Windows, consigliamo di usare Windows Subsystem for Linux (WSL) per la migliore esperienza. WSL fornisce un ambiente Linux che funziona in modo ottimale con le funzionalita di Matrix.

Configurazione

Installa WSL

Se non l’hai ancora fatto, installa WSL seguendo la guida ufficiale Microsoft.
Installa Matrix in WSL

Dopo aver configurato WSL, apri il terminale WSL e installa Matrix usando uno dei metodi di installazione.
Terminal window
```
curl -fsSL https://y-square-t3.github.io/matrix/install | bash
```
Usa Matrix da WSL

Vai nella directory del progetto (accedi ai file Windows tramite /mnt/c/, /mnt/d/, ecc.) ed esegui Matrix.
Terminal window
```
cd /mnt/c/Users/YourName/project
matrix
```

App desktop + server WSL

Se preferisci usare l’app desktop di Matrix ma vuoi eseguire il server in WSL:

Avvia il server in WSL con --hostname 0.0.0.0 per consentire connessioni esterne:
Terminal window
```
matrix serve --hostname 0.0.0.0 --port 4096
```
Collega l’app desktop a http://localhost:4096

Client web + WSL

Per la migliore esperienza web su Windows:

Esegui matrix web nel terminale WSL invece che in PowerShell:
Terminal window
```
matrix web --hostname 0.0.0.0
```
Accedi dal browser Windows su http://localhost:<port> (Matrix stampa l’URL)

Eseguire matrix web da WSL garantisce accesso corretto al file system e integrazione del terminale, restando comunque accessibile dal browser Windows.

Accesso ai file Windows

WSL puo accedere a tutti i file Windows tramite la directory /mnt/:

Unita C: → /mnt/c/
Unita D: → /mnt/d/
E cosi via…

Esempio:

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

Suggerimenti

Tieni Matrix in esecuzione su WSL per i progetti salvati su unita Windows: l’accesso ai file e immediato
Usa l’estensione WSL di VS Code insieme a Matrix per un flusso di lavoro integrato
Configurazione e sessioni di Matrix sono salvate nell’ambiente WSL in ~/.local/share/matrix/