Requirements
- A Linux distribution with systemd (Ubuntu, Debian, Fedora) or WSL2.
- Node.js 20+ and curl.
Install
$ curl -fsSL https://remoteagent.online/install.sh | bash
Log in
- Run
remoteagent login. - Open the printed link and approve the device.
- Verify with
remoteagent status.
Run as a background service
The installer can register a systemd service so the agent survives reboots. If you installed manually, start it in the foreground with remoteagent start or use the daemon command.
WSL2 notes
i
WSL2 works, but filesystem access to Windows paths is slower. Keep the agent workspace inside the Linux filesystem for the best results.
Troubleshooting
If the service will not start, run remoteagent doctor and check the journal: journalctl -u remoteagent -n 50.