get started / Pair a phone

Pair a phone

Pairing links one phone to one machine. It takes a few seconds and works on any network.

$ pgpu pair [--permission view|control|shell]

How it works

pgpu pair shows a QR code and an eight-character code. Scan the QR code in the app, or type the code on another network. Codes work once and expire after five minutes.

The terminal then shows the phone’s name and key. Press c to allow it with Control, v for View only, s for Shell, or d to deny.

Permissions

View sees stats, jobs and alerts. Control can also run quick actions, stop jobs and kill processes. Shell can also create and edit actions.

Change a phone’s permission later with pgpu devices set; see pgpu devices.

All docs pages