Luna Display Setup Error
If you are getting an error message similar to the one below, this typically indicates an issue with hardware compatibility.
Why would I get this message?
Even if your Mac meets our minimum system requirements, there could be other things that are affecting how Luna is able (or not able) to communicate with your Mac.
Your Mac has reached its external display limit
Luna uses the same industry standards as a regular monitor, so it behaves like a regular monitor and would count as a USB-C display or Mini DisplayPort display.
Macs can only output to a certain number of external displays, which can be found in your Mac's technical specifications. This number will vary depending on the year and model of your Mac. You can find the technical specifications for your specific Mac here:
|List of Macbook Pro models||List of Macbook Air models|
| List of Macbook models
||List of iMac models|
|List of Mac mini models|| List of Mac Pro models
Understanding your Mac's technical specifications
Once you have found your Mac's technical specifications, scroll down until you find the Video Support section. For example, here is the Video Support section for a 2020 M1 Mac mini:
These specifications tell us that the M1 Mac mini can support two external displays: one display connected using Thunderbolt (USB-C) and one display connected using HDMI. Since a USB-C Luna would be connected using the Thunderbolt (USB-C) port, Luna would count as a USB-C display. The only other display that can additionally be connected to the Mac mini would need to be connected using the HDMI port.
Luna is plugged into an incompatible port or adapter
We highly recommend plugging Luna directly into a compatible port on your Mac, instead of using an adapter, dock, or hub. → Learn More
Luna needs to be plugged into a port that can support video or display output. The USB-C Luna uses DisplayPort Alt Mode protocol, so it needs to be plugged into a port that supports this or Thunderbolt protocol. The Mini DisplayPort Luna only supports mini DisplayPort and DisplayPort protocols.
For example, the 2021 M1 24-inch iMac comes with an option for an expanded model of two Thunderbolt/USB 4 ports and two USB 3 (Type-C) ports, as shown on the right of the image below. Luna can only work if it is plugged into one of the Thunderbolt/USB 4 ports, as those have support for display output. Even though the USB 3 ports have the same shape, they do not have support for display output and are only used for data transfer.
Other USB devices are preventing your Mac from recognizing Luna
If you have other Thunderbolt or USB devices plugged into your Mac, they may be using up all of your port resources and not leaving any resources for Luna to communicate with your Mac.
On Intel-chip Macs, even if there are multiple Thunderbolt ports, each pair of Thunderbolt ports share one Thunderbolt bus controller. By sharing a Thunderbolt bus controller, the ports share the same Thunderbolt bandwidth with each other.
For example, a 2019 Macbook Pro has four Thunderbolt 3 ports (two on each side of the Macbook Pro). Each side of the Macbook Pro has one Thunderbolt bus controller, which is shared by both Thunderbolt 3 ports on that side.
If you have a Thunderbolt or USB device connected to the same Thunderbolt bus controller as Luna, there is a chance that the Thunderbolt or USB device is using most or all of the bandwidth from the Thunderbolt bus controller, and not leaving enough bandwidth for Luna. This is common with Thunderbolt docks or hubs, or external monitors with resolutions of 4K and higher.