Windows (WSL2)

Mayros di Windows direkomendasikan melalui WSL2 (Ubuntu direkomendasikan). CLI + Gateway berjalan di dalam Linux, yang menjaga runtime konsisten dan membuat tooling jauh lebih kompatibel (Node/Bun/pnpm, binary Linux, skills). Native Windows mungkin lebih rumit. WSL2memberi Anda pengalaman Linux penuh — satu command untuk menginstal: wsl --install.

Aplikasi companion native Windows direncanakan.

Instal (WSL2)

Gateway

Instalasi service Gateway (CLI)

Di dalam WSL2:

mayros onboard --install-daemon

Atau:

mayros gateway install

Atau:

mayros configure

Pilih Gateway service saat diminta.

Perbaiki/migrasi:

mayros doctor

Advanced: expose service WSL melalui LAN (portproxy)

WSL memiliki jaringan virtual sendiri. Jika mesin lain perlu mencapai service yang berjalan di dalam WSL (SSH, server TTS lokal, atau Gateway), Anda harus meneruskan port Windows ke IP WSL saat ini. IP WSL berubah setelah restart, jadi Anda mungkin perlu me-refresh aturan forwarding.

Contoh (PowerShell sebagai Administrator):

powershell
$Distro = "Ubuntu-24.04"
$ListenPort = 2222
$TargetPort = 22

$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
if (-not $WslIp) { throw "WSL IP not found." }

netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `
  connectaddress=$WslIp connectport=$TargetPort

Izinkan port melalui Windows Firewall (satu kali):

powershell
New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow

Refresh portproxy setelah restart WSL:

powershell
netsh interface portproxy delete v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 | Out-Null
netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 `
  connectaddress=$WslIp connectport=$TargetPort | Out-Null

Catatan:

  • SSH dari mesin lain menargetkan IP host Windows (contoh: ssh user@windows-host -p 2222).
  • Node remote harus mengarah ke URL Gateway yang dapat dijangkau (bukan 127.0.0.1); gunakan mayros status --all untuk konfirmasi.
  • Gunakan listenaddress=0.0.0.0 untuk akses LAN; 127.0.0.1 menjaga lokal saja.
  • Jika Anda ingin ini otomatis, daftarkan Scheduled Task untuk menjalankan langkah refresh saat login.