Quick answer:

Restart both your Mac and iPad completely, then reconnect Luna Display
Check connections: Ensure the Luna unit is firmly plugged in and both devices are on the same Wi-Fi network
Verify apps are running: Luna Display should be active on both Mac and iPad
Try different ports/cables if you have them available
Update the Luna Display Apps: Ensure both the desktop and secondary device apps are up to date. On the desktop app, click Luna Display in the menu bar and select About Luna Display to check the version.

Having trouble with your Luna Display? You're in the right place! Most display issues have simple solutions, so let's get you back up and running quickly.

⚡Universal Quick Fixes

Step 1: Restart Everything

The tried-and-true method that fixes most temporary glitches:

Mac: Fully restart (not just sleep/wake)
iPad: Power off completely, then turn back on
Luna Display: Unplug and reconnect the hardware unit
Update Apps: Ensure both the Mac and iPad apps are updated to the latest version.

Step 2: Check Your Connections

Connection issues are super common and easy to fix:

Physical Connections

Luna unit: Make sure the Luna Display unit is properly inserted into the proper port
Test with a different cable if you have one handy
1. Try a Thunderbolt, Ethernet, or USB cable (USB available for macOS 10.15+)
Try a different port on your Mac if available

Wireless Connection

Wi-Fi: Both devices must be on the same network
Wi-Fi Network: Connect to the 5G network for the best connection
Network strength: Move closer to your router if signal is weak
Switch to a Wired Connection: For optimal performance, use a wired connection such as Thunderbolt, Ethernet, or USB. Wired connections typically provide lower latency and minimal lag.

Step 3: Display Settings Check

Display Settings

Force detection: Go to System Preferences > Displays and click "Detect Displays"
Reset display settings: Hold Option key and click "Scaled" to see additional resolution options
Mirror vs. Extend: Make sure "Mirror Displays" is unchecked unless you want identical screens
Arrangement: Click the "Arrange" tab and drag the Luna Display rectangle to match your physical setup
Revoke App Access: Reset the connection by revoking app access. On the desktop app, go to Luna Settings > Connectivity > Revoke Access. Afterward, fully quit and relaunch the apps.

Advanced Troubleshooting

Perform a Factory Reset: Restore the default preferences of the Luna Display app by performing a factory reset. This can resolve abnormal app behavior. Refer to the factory reset guide in the help center for instructions.

If these quick fixes didn't solve your problem, don't worry! We have detailed solutions for specific issues:

→ Troubleshooting Luna Display Quality Issues

Covers blurry displays, resolution problems, pixelation, and performance issues