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. WSL2 memberi 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.

Instalasi WSL2 langkah demi langkah

1) Instal WSL2 + Ubuntu

Buka PowerShell (Admin):

powershell
wsl --install
# Atau pilih distro secara eksplisit:
wsl --list --online
wsl --install -d Ubuntu-24.04

Restart jika Windows memintanya.

2) Aktifkan systemd (diperlukan untuk instalasi gateway)

Di terminal WSL Anda:

bash
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

Kemudian dari PowerShell:

powershell
wsl --shutdown

Buka kembali Ubuntu, lalu verifikasi:

bash
systemctl --user status

3) Instal Mayros (di dalam WSL)

Ikuti alur Getting Started Linux di dalam WSL:

bash
git clone https://github.com/ApiliumCode/mayros.git
cd mayros
pnpm install
pnpm ui:build # auto-instal UI deps pada run pertama
pnpm build
mayros onboard

Panduan lengkap: Getting Started

Aplikasi companion Windows

Kami belum memiliki aplikasi companion Windows. Kontribusi sangat diterima jika Anda ingin membantu mewujudkannya.