Install the agent

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

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.

Install on macOS (Apple Silicon)

Open Terminal and paste the command below. Requires macOS 12+ on Apple Silicon (M1/M2/M3).

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

Open Terminal (Applications → Utilities → Terminal).

Paste the command above and press Enter. Enter your password when prompted. The installer downloads the agent, configures it with your token, and registers it as a launchd 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: macOS 12 Monterey or later on Apple Silicon (M1/M2/M3). Intel Mac support coming soon.

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.