Running a headless Mac mini from your desk

A Mac mini does its best work when nobody is sitting at it. It runs the long build, the test suite, the agent that has been going since lunch, and it does all of that without a display, a keyboard or a chair. The catch has always been the moment you need to look at something.

Beam treats a headless Mac like any other Mac. Its windows list in the picker the same way, and any one of them opens on the machine in front of you. This post is the setup, start to finish.

What you need

• Two Macs on macOS Sonoma or later, with Beam installed on both.
• The same network. Wi-Fi is enough. If the mini lives somewhere else, Tailscale on both Macs does the rest.
• A way to reach the mini once, to grant permissions. Screen Sharing, a temporarily attached display, or SSH.

Setting up the mini

Install Beam on the mini and open it once. macOS will ask for two permissions on the Mac doing the sharing: Screen Recording, so Beam can show the window you pick on the Mac in front of you, and Accessibility, so it can deliver your input to it. Both are granted once and remembered.

If the mini has no display attached, the easiest route is over SSH. Beam ships a command line with a doctor that checks the permissions and the network on that Mac, and whether the other Mac can reach it, and tells you which step is missing. Run it, follow what it says, and you are done with the closet.

Sign in to Beam on both Macs. A new Mac waits until you approve it, from a Mac you already approved or from a link we email you.

Day to day

From then on, the mini's windows appear in Beam's picker on your desk Mac. Pick the terminal running the build and it opens as a window. Pick the browser the agent is driving and watch it work. Pick both and put them side by side.

When you are done, there is nothing to tidy up. Close the beamed window and the app carries on over there exactly as it was.

No display needed

A Mac with no display attached can share its windows too. Once its permissions are granted, the mini can stay in the closet doing its work.

For the things a mini is actually for, builds, tests, agents and the odd long-running script, the setup above is all there is to it. The mini stays in the closet. Its windows come to you.