Skip to content
Guide: Get started

Set up a headless Mac

For a Mac with nobody at it, like a Mac mini: add it as a new device with Headless setup ticked, and it logs in by itself, so eris comes back after every restart.

eris.talk

Add a device, with Headless setup ticked.

You run the command on the Mac

Your Mac

Installs eris, and sets itself to log in alone.

After a restart

Online

It logs in and starts eris by itself.

  1. On the Mac, turn on Remote Login in System Settings → General → Sharing, so you can reach it later without a screen.
  2. On eris.talk, open Devices and press Add a device, as for any new device.
  3. Name it and press Create token. Under the install command, tick Headless setup: the command gains --headless.
  4. On the Mac, logged in as the account eris should use, run the command in a terminal. Give your password when it asks.
  5. Restart the Mac. It logs in by itself, starts eris, and shows up online on Devices.

Already added the Mac? Run sudo eris setup --headless on it instead of steps 2–4.

  • FileVault stops a Mac logging in by itself. Turning it off (sudo fdesetup disable) leaves a stolen Mac's disk readable. Or keep it: log in with Screen Sharing now, and after each restart, unlock it with SSH first.
  • To reach the Mac from elsewhere, use Tailscale.
  • Optionally, add --user eris to the command to give eris a standard account of its own, without admin rights, so yours stays clean to recover from. It doesn't protect eris's own history and keys.
  • Give eris scoped keys and tokens of its own.