Machines

A machine is one PortPilot agent install. Free allows 1 paired machine. Pro uses the purchased count (1, 3, 5, or 10). Cloud seats are max(Pro seats, 3). Capacities do not stack.

Prerequisites

An account. Pairing is optional for local Desktop/CLI use.

Website

• Machines lists paired hosts, online/offline, and last seen
• Add machine creates a pairing code
• Machine settings: display name, environment, tags, pin, revoke
• Offline ports can show as STALE; controls are not queued

Desktop

Nav: Machine. First-run offers Enter pairing code or Use locally. Restart agent and pairing live here. Open Dashboard opens https://portpilot.app.

Seats

Revoking a machine immediately frees a seat. The same machine UUID after revoke reuses the seat. Licences are not transferable between accounts.

Expected result

Online machines show live ports. Offline machines remain listed with last seen.

Common problems

See Pairing troubleshooting and Licensing.