ORelay Agent is installed

If your organisation set this Mac up for ORelay, there is nothing more to do: it will appear in your ORelay account shortly.

Connecting it yourself

Click the ORelay icon in the menu bar, choose Open ORelay, and scan the code it shows with your phone (or open ORelay on your phone, choose Add a computer, then Scan). Once your phone has approved it, click Join. macOS asks for an administrator's password once.

For administrators: sudo /usr/local/bin/orelay-agent join shows the same code in Terminal, or takes a code from Add a computer typed in.

Remote desktop

To let someone see this screen, allow orelay-session-helper in System Settings › Privacy & Security › Screen & System Audio Recording. macOS asks for this once, from someone at this Mac.

If this Mac had the agent before

An earlier version installed the agent under different names. This installer moved it to the new ones, and the Mac keeps its place in your ORelay account. macOS ties its privacy permissions to a program's name and place, though, so the ones given before do not carry over: allow orelay-session-helper again under both Screen & System Audio Recording and Accessibility. The old entries, called opsrelay-session-helper, no longer do anything and can be removed there with the − button.

To remove the agent: sudo /usr/local/share/orelay/uninstall.sh. It asks what to keep, and whatever it keeps, installing again picks up: the same settings, and the same computer in your account. To remove everything, so the next install starts fresh, add --remove-all.

Help and support