Install the agent

The Leassh agent is the easiest way to connect machines. One command, three minutes, full monitoring.

If you prefer SSH-based monitoring (no software installed on targets), see the Self-Hosting docs.

Find this in your Leassh dashboard under Devices > Add Device. The install command below will update automatically.

Install on Windows

Open PowerShell as Administrator and paste the command below.

Quick install powershell -ExecutionPolicy Bypass -Command "& { $env:LEASSH_TOKEN='YOUR_TOKEN'; iwr -useb https://leassh.com/install-windows.ps1 | iex }"
Or download directly https://github.com/cgoberg/releases/releases/latest/download/leassh-agent-windows-x64.tar.gz

Open PowerShell as Administrator. Right-click the Start menu, choose "Windows Terminal (Admin)" or "PowerShell (Admin)".

Paste the command above and press Enter. The installer will download the agent from GitHub releases, configure it with your family token, and register it as a Windows service.

Verify in your dashboard. Open your Leassh dashboard (OpenClaw plugin or standalone runner at http://localhost:8080) — your device will appear within a minute of installation.

Requirements: Windows 10 or later. PowerShell 5.1+. Internet connection for the initial download. SSH does not need to be enabled on this machine — the agent communicates outbound to your Leassh server.

macOS is not available

The current release has no Apple Silicon or Intel Mac package. Windows and Linux are the current install paths. macOS access stays closed until release packages exist.

Status: There is no macOS installer or download in this release. Use the Windows or Linux tabs if those are your machines.

Install on Linux

Open a terminal and paste the command below.

Quick install curl -fsSL https://leassh.com/install.sh | sudo LEASSH_CODE='YOUR_CODE' bash
Or download directly x64: https://github.com/cgoberg/releases/releases/latest/download/leassh-agent-linux-x64.tar.gz arm64: https://github.com/cgoberg/releases/releases/latest/download/leassh-agent-linux-arm64.tar.gz

Open a terminal. On Ubuntu/Debian: Ctrl+Alt+T. On other distros, use your terminal emulator of choice.

Paste the command above and press Enter. Enter your password when prompted. The installer auto-detects your architecture (x64 or ARM64) and downloads the correct binary from GitHub releases.

Verify in your dashboard. Open your Leassh dashboard (OpenClaw plugin or standalone runner at http://localhost:8080) — your device will appear within a minute of installation.

Requirements: A systemd-based Linux distribution (Ubuntu 20.04+, Debian 11+, Fedora 35+, etc.). curl or wget. The agent installs as a systemd service and starts automatically on boot.