Set up Leassh

Free alpha is open in principle, but self-serve registration is temporarily paused while the account service is under maintenance. Request access, then use the install path below once you have a pairing code.

1

Registration is paused

The account service does not accept new self-serve signups right now. Email us for an alpha invitation; we will send a pairing code when the customer path is ready.

Request Alpha Access

Windows and Linux agents are the current install paths. macOS packages are not available in the current release. Paid plans and checkout are not open.

2

Set up your server

For invited alpha users with a pairing code. The server collects data from agents and serves the local dashboard. Self-hosted only.

Add these to your fleet.yaml configuration:

# fleet.yaml rendezvous: pairing_code: ABC123 api_key: your-api-key url: https://leassh.com/api/rendezvous

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

For invited alpha users. Install the agent on each computer you want to monitor. It connects to your server using the pairing code from your invitation.

Windows

Run in PowerShell as Administrator. Replace ABC123 with your pairing code.

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

macOS

Not available in the current release

No Apple Silicon or Intel Mac agent package ships today. Use Windows or Linux until macOS packages exist.

Linux

Run in terminal (Debian, Ubuntu, Fedora, Arch). Replace ABC123 with your pairing code.

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

Have SSH access already?

Deploy a Windows/Linux agent remotely without touching the machine

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