Windows via WSL2
The agent runs inside WSL2, which gives it a Linux environment on Windows. That is the supported path for Windows machines.
Set it up
- Enable WSL2 and install a distro (Ubuntu is the default choice).
- Install Node.js 20+ inside the distro.
- Run
curl -fsSL https://remoteagent.online/install.sh | bash. - Log in with
remoteagent login.
Filesystem note
Keep the agent workspace inside the Linux filesystem. Accessing Windows paths through WSL is slower and can cause permission quirks.
What works
- Sandboxed shell inside the distro.
- File operations in the workspace.
- The dashboard and CLI as normal.
- Scheduled jobs via systemd or cron.
If it will not start
$ remoteagent doctor