LIMONATA RENTAL SSH CLIENT 1

Use this client on your Windows, Linux or macOS computer. It connects to a
funded, active Limonata Linux VM. It does not turn a Windows provider into a VM
host and does not bypass the marketplace's payment/availability gates.

Prerequisites: Node.js 22 or newer (https://nodejs.org/en/download) and OpenSSH
client (ssh, ssh-keygen). No npm install is needed. Unzip into a local folder.
Commands below work in PowerShell from that folder. Keep the client running.

Before booking:
  node .\ssh-client.mjs prepare --identity .\rental-id
Choose an SSH-key passphrase when prompted. Paste the displayed PUBLIC key
(rental-id.pub) in the Linux VM booking form. Never upload rental-id itself.
You can reuse an existing SSH identity and paste its .pub content instead.

After the rental becomes active:
1. In Limonata, open My rentals > Open workspace > Linux server.
2. Create a rental access key. Save just that key in rental-api-key.txt in a
   private folder owned by you. Do not share, commit or screenshot the key.
3. Copy the rental ID shown in the workspace and run:
  node .\ssh-client.mjs connect --order YOUR_32_CHARACTER_ORDER_ID --identity .\rental-id --key-file .\rental-api-key.txt

Linux/macOS: use ./ in place of .\ and chmod 600 rental-id rental-api-key.txt.
The API key is sent inside authenticated WSS, not in a URL or SSH argument.
The private SSH key stays on your computer. SSH host keys use a separate alias
for each rental and are checked by OpenSSH on subsequent connections.
Connection failure means the rental/provider/key is unavailable or expired;
check the workspace and provider console. A provider needs agent 1.4.0+.

The renter user has sudo inside the Linux guest. For example:
  sudo apt-get update
  sudo apt-get install git
HTTP/HTTPS downloads use the VM's configured proxy; other outgoing protocols
and public incoming ports are not available. No GPU passthrough is provided.
Each relay connection is limited to 1GiB total and a 4MiB/second burst budget.
The SSH connection ends at rental expiry or key revocation. Guest data and
installed programs are temporary. Copy anything you need before expiry.
Delete your local API-key file afterwards. Locally saved files are not erased
by Limonata. The provider controls the host and can inspect its guest data.

This package contains source only, no model, private key or bundled runtime.
Native Windows execution and real VM acceptance require testing on that hardware.
