Headless Mode — Setting up Luna Display

What is Headless Mode?

What is Headless Mode?

Using Luna Display in Headless Mode allows you to use your iPad or secondary Mac as the primary display for a Mac mini or Mac Studio. It’s a great way to combine the power of a desktop Mac with the convenience of another screen — no external monitor required after setup.

Note: Luna Display for Windows is not optimized for Headless Mode. While similar steps can be followed, we can't guarantee performance and support is limited.

Important: You will need an external monitor for the initial setup. To run Headless Mode every time you start your Mac mini or Mac Studio (without needing a monitor), make sure to:

  • Set up Automatic Login
  • Disable FileVault
  • Add Luna Display to Login Items

This ensures Luna launches automatically and connects to your iPad or secondary Mac when your computer powers on.

Using an M1 Mac mini? You'll need to use an HDMI display for setup. Thunderbolt/USB-C only supports one display for this model of Mac. 

Using a Mac Studio or M4 Mac Mini? Be sure to plug Luna Display into one of the Thunderbolt 4 ports on the back. The front ports do not support displays.

How to Set Up Headless Mode

1. Connect an external monitor for setup
Also connect a keyboard and mouse or trackpad to your Mac mini or Mac Studio.

2. Download the Luna primary app
While the external monitor is connected, download the Luna app: Download Luna for Mac

3. Disable FileVault
This allows automatic login to work properly.

  • macOS Monterey: Go to System Preferences > Security & Privacy > FileVault, then click Turn Off FileVault.
  • macOS Ventura and later: Go to System Settings > Privacy & Security > FileVault, then click Turn Off.

4. Set up Automatic Login

  • macOS Monterey: Go to System Preferences > Users & Groups > Login Options. Select your user account under "Automatic login."
  • macOS Ventura and later: Go to System Settings > Users & Groups and turn on "Automatically log in as".

5. Add Luna Display to Login Items

  • macOS Monterey: Go to System Preferences > Users & Groups > Login Items, then click the + and add Luna Display.
  • macOS Ventura and later: Go to System Settings > General > Login Items and add Luna Display from there.

Trouble adding Luna Display on Ventura or later?
Some macOS versions prevent apps from being added to login items. If this happens:

  • Open Luna Display on your Mac
  • Right-click the Luna icon in the dock
  • Go to Options > Open at Login
  • Reboot your Mac if it doesn't save the setting the first time

6. Install the Luna Secondary app
Download the free Luna Display app on your secondary device:

7. Connect both devices to the same network
We recommend connecting to the same Wi-Fi network. If your network is unstable or unavailable, you can use a supported cable instead. Learn about cable options here.

8. Launch Luna and follow the prompts
Open Luna on both your Mac mini (or Studio) and your iPad or secondary Mac. Follow the onscreen instructions and connect Luna Display to your desktop.

9. Disconnect the external monitor
Once the Luna connection is active, you can safely disconnect the monitor.

Reminder: A user must be logged in for Luna to launch. If FileVault is enabled, your Mac may still require a monitor at boot to unlock your drive.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us