Set up Leassh

Create an account, configure your server, and install agents on the machines you want to monitor. Takes about three minutes.

Create your account

Enter your email to get a pairing code. This code links your server and agents together.

Your Pairing Code

Write this down. You will need it to connect agents to your server.

API Key

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
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

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"