Machines

Logging in

Open the panel and sign in with your username and password, or click Sign in with Passkey once you have registered one.

A session lasts 24 hours and ends after 2 hours idle (session_idle_timeout). The header holds Machines, Templates, History, Settings (Connection keys, Users) and your account menu (Account & security, Log out).

The list

Column	Shows
Machine	The name. A number beside it expands the machine’s earlier sessions. N× in 24 h marks a machine that reconnected five or more times today
Hostname, Distro, Public IP	As the agent reports them
Health	CPU, RAM and the fullest disk, live. Offline: last seen
State	Online with Connect; In use by you with Open; In use by olena · 5m; Offline with a bell
Agent	The agent’s version. Update available when it is older than the server
Note	The latest note
Connected, Session ID, Client ID	Hidden by default — the columns button at the right of the header shows them

Filters. All / Online / In use / Offline; Outdated agents; search by name, IP, hostname or note (/ focuses it). The filters, search and page are kept in the address. The pin icon shows pinned groups: pin machines into named groups from the pin on each row.

Selection. Space selects a row; Actions then offers Copy IPs, Copy Session IDs, Force Release and Delete (the session records of offline machines).

Keyboard. From the search box, ↓ moves into the rows. ↑ / ↓, Home, End; Enter connects or opens; Space selects. The sort headers are buttons.

Browser tab. The title carries the number of connected machines, and in a workspace the machine’s name — ● web-prod-01 — WoHo while it is online.

Go to a machine

Alt+K anywhere (⌘K on a Mac; / on the list) opens a switcher: type part of a name, hostname, IP or note, pick with ↑ / ↓, Enter opens it.

Detail panel

Click a row.

Section	Contents
Identity	Session ID, IP address and port, client ID (each with a copy button), OS, kernel, architecture, CPU model, memory, VM / container, boot time, timezone, LAN addresses, hostname, agent version, admin, connected, duration
System stats	CPU, RAM, every disk (a mount at 90 % or more flagged), load, swap, round-trip time, clock offset (flagged beyond ±2 s), uptime, network. Shown at once with their real age: updated 6 s ago
Notes	Notes about the machine, by any admin, kept across reconnects. Add one in the box; edit or delete from the list
Buttons	Connect or Open; Force release when another admin holds it, with who and for how long; Update agent; Notify me when it connects on an offline machine; Timeline

The hardware and OS facts, every mount, swap and the round-trip time need the current agent; an older one shows — for them.

Timeline

Timeline in the detail panel or the workspace header: what happened on this machine, newest first.

Connections with their address; disconnects with the reason — agent closed, read timeout, replaced by a new connection, key revoked, closed by admin, server shutdown; refused registrations and why; claims and releases; terminals, commands, web sessions, file operations and notes, each with the admin. Show filters by kind, Admin by who. Recorded terminals have a Replay button. All actions in History opens the same machine in History.

A machine stays listed under Offline after its sessions have aged out of retention, with when it was last seen.

Notify me when it connects

The bell on an offline row, or the button in its detail panel, tells you once when that machine connects: a browser notification, a notice in the panel and a flashing tab title. It belongs to this browser tab only, ends when the tab closes, and nothing is stored on the server. The first click asks the browser’s permission; without HTTPS, or if you refuse, you still get the notice and the flashing title. Click the bell again to stop waiting.

Update agent

An agent older than the server is marked Update available in the list and agent update available in the workspace header.

Update agent in the detail panel or the workspace header downloads the new binary from the Client Download URL on the Connection keys page, verifies its .sha256, and restarts the agent; the panel follows Downloading → Restarting → Reconnected with vX, or shows the agent’s reason. Offered for a Linux agent installed as the service. See Updating.

Troubleshooting

Symptom	Check
A machine never appears	On the machine: systemctl status woho-client, journalctl -u woho-client -n 50. Outbound TCP 9000 to the server must be open. A refused key shows on the Connection keys page and in History
It shows Offline but the agent runs	The agent is reconnecting: check its journal for the TLS or key error named there
In use by another admin who has left	Their session is still alive. Force release it; the lock ends on its own when their session expires
Stats show —	The agent is older than the panel. Update it