Set up Leassh

Create your free account, get a license key and pairing code, then install agents on up to two computers. Takes about three minutes.

1

Create your free account

Enter your email to get a Free license for 2 computers, a pairing code, and one Home Assistant ha API token. No card required.

Your Free license key
LSH-XXXXX-XXXXX-XXXXX-XXXXX
Add this to fleet.yaml. It covers 2 computers and does not expire.
Your Pairing Code
Write this down. You will need it to connect agents to your server.
Home Assistant API token (ha)
Free includes exactly one API token, scoped to ha. Using Home Assistant and OpenClaw at the same time requires Family or Pro.
2

Set up your server

The server collects data from agents and serves the dashboard. Self-hosted only.

Add these to your fleet.yaml configuration:

# fleet.yaml license_key: LSH-XXXXX-XXXXX-XXXXX-XXXXX nodes: - name: my-pc host: 192.168.1.20 ssh: user@192.168.1.20 api: enabled: true listen: 0.0.0.0:8790 tokens: ha: your-api-key

Then start the server. Download the binary from GitHub Releases:

# Linux x64 curl -L https://github.com/cgoberg/releases/releases/latest/download/leassh-server-linux-x64.tar.gz | tar xz ./leassh fleet.yaml

Docker option — the container image requires a GitHub login:

docker login ghcr.io # GitHub username + personal access token docker run -d --name leassh-server \ -p 8383:8383 \ -v ./fleet.yaml:/app/fleet.yaml \ ghcr.io/cgoberg/leassh-server:latest
3

Install agents

Install the agent on each computer you want to monitor. It connects to your server using the pairing code.

Windows

Run in PowerShell as Administrator

$env:LEASSH_CODE='ABC123'; irm https://leassh.com/install.ps1 | iex

macOS

Run in Terminal

⚠ Apple Silicon only Requires an M1, M2, or M3 Mac. Intel Mac support is coming soon.
curl -fsSL https://leassh.com/install.sh | sudo LEASSH_CODE=ABC123 bash

Linux

Run in terminal (Debian, Ubuntu, Fedora, Arch)

curl -fsSL https://leassh.com/install.sh | sudo LEASSH_CODE=ABC123 bash

Have SSH access already?

Deploy the agent remotely without touching the machine

ssh user@machine "curl -fsSL https://leassh.com/install.sh | sudo LEASSH_CODE=ABC123 bash"