Setting up Luna Display in Headless Mode
What is Headless Mode?
Using Luna Display in headless mode allows you to turn your iPad or secondary Mac into the primary display for a Mac mini or Mac Studio. It allows you to combine the processing power of your Mac mini or Mac Studio with the touch display of the iPad or the screen real estate of a secondary Mac computer.
An external monitor is required for the initial setup to connect the Mac mini or Mac Studio and the iPad or secondary Mac computer. To avoid using an external display every time your computer is turned on after the initial setup, you will also need to:
- Set up Automatic Login
- Disable FileVault
- Add Luna Display to Login Items
Setting up Automatic Login, disabling FileVault, and adding Luna to your login items allows the Luna software to run at startup and connect to your iPad or secondary Mac computer.
If you are using a Mac Studio, you must plug Luna Display into one of the Thunderbolt 4 ports on the back of the Mac Studio as the ports in the front of the Mac Studio do not support Displays.
Setting Up Headless Mode
An external monitor is required for the initial setup process. We also recommend connecting an external keyboard and mouse or trackpad to your computer.
In System Preferences > Security & Privacy > FileVault, select "Turn Off FileVault". If the option is greyed out, click the padlock in the bottom left corner to make changes.

After disabling FileVault, go to System Preferences > Users and Groups > Login Options. Select your preferred account for automatic login. If the option is greyed out, click the padlock in the bottom left corner to make changes and make sure FileVault is disabled first.
Next, go to System Preferences > Users and Groups > Login Items. Click the " +" below the list of items, select Luna Display from the next list of items that comes up, and then click " Add". Click the padlock in the bottom left to make these changes.