Windows (WSL)

Embora o matrix possa rodar direto no Windows, recomendamos usar Windows Subsystem for Linux (WSL) para a melhor experiência. O WSL oferece um ambiente Linux que funciona de forma integrada com os recursos do matrix.

Por que WSL?

O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a terminal e compatibilidade com as ferramentas de desenvolvimento das quais o matrix depende.

---

Configuração

1. Instale o WSL

   Se ainda não instalou, instale o WSL usando o guia oficial da Microsoft.

2. Instale o matrix no WSL

   Depois de configurar o WSL, abra o terminal do WSL e instale o matrix usando um dos métodos de instalação.

   curl -fsSL https://y-square-t3.github.io/matrix/install | bash

3. Use o matrix pelo WSL

   Vá para o diretório do seu projeto (acesse arquivos do Windows via /mnt/c/, /mnt/d/ etc.) e execute o matrix.

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

---

App desktop + servidor WSL

Se você prefere usar o app desktop do matrix, mas quer rodar o servidor no WSL:

1. Inicie o servidor no WSL com --hostname 0.0.0.0 para permitir conexões externas:

   matrix serve --hostname 0.0.0.0 --port 4096

2. Conecte o app desktop em http://localhost:4096

Nota

Se localhost não funcionar no seu ambiente, conecte usando o IP do WSL (no WSL: hostname -I) e use http://<wsl-ip>:4096.

Cuidado

Ao usar --hostname 0.0.0.0, defina MATRIX_SERVER_PASSWORD para proteger o servidor.

MATRIX_SERVER_PASSWORD=your-password matrix serve --hostname 0.0.0.0

---

Cliente web + WSL

Para a melhor experiência web no Windows:

1. Execute matrix web no terminal WSL em vez do PowerShell:

   matrix web --hostname 0.0.0.0

2. Acesse pelo navegador do Windows em http://localhost:<port> (o matrix mostra a URL)

Executar matrix web a partir do WSL garante acesso correto ao sistema de arquivos e integração com o terminal, continuando acessível no navegador do Windows.

---

Acessar arquivos do Windows

O WSL pode acessar todos os arquivos do Windows pelo diretório /mnt/:

• Unidade C: → /mnt/c/
• Unidade D: → /mnt/d/
• E assim por diante…

Exemplo:

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

Dica

Para uma experiência mais fluida, considere clonar/copiar seu repositório para o sistema de arquivos do WSL (por exemplo em ~/code/) e executar o matrix por lá.

---

Dicas

• Mantenha o matrix rodando no WSL para projetos armazenados em unidades do Windows - o acesso aos arquivos fica fluido
• Use a extensão WSL do VS Code junto com o matrix para um fluxo de desenvolvimento integrado
• Sua configuração e suas sessões do matrix ficam armazenadas no ambiente WSL em ~/.local/share/matrix/