Quick answer:
Make sure these basics are covered:
Luna Display hardware is plugged directly into your Mac/PC port
Both devices are on the same WiFi network and bandwidth (5GHz vs 2.4GHz)
WiFi is enabled on both devices
Correct Luna apps are running on both devices
No firewall or security programs are blocking the connection
Verify Local Network Access permissions: Go to System Settings > Privacy & Security > Local Network and ensure Luna Display is enabled.
Try these solutions
Restart everything: Restart both your primary device and secondary device, plus your router. After the restart, relaunch the Luna Display app on both devices to check if the connection is re-established.
Cable kickstart: Connect your Mac/PC and secondary device with a USB, Ethernet, or Thunderbolt cable first to establish the connection, then unplug once connected
Manual connection: Use Manual WiFi connection in Luna Display (see instructions below)
Revoke Access: Open the Luna Display desktop app, navigate to
Settings > Connectivity > Revoke Access, and select Revoke Access to reset the connection. Close and relaunch both the desktop and client apps before trying to connect again. This can often resolve abnormal connection behaviors.Perform a Factory Reset: Reset the Luna Display settings to their default configuration to resolve abnormalities. After completing the reset, relaunch the app on both devices to test the connection.
Manual WiFi Connection
When automatic connection isn't working, try a manual connection:
At the connection screen, click "Connect info" to open the connection options window.
Click "WiFi Manual Connect" to get your connection details.
Now connect your secondary device:
Your connection numbers will be different from any examples shown.
Performance Optimization Tips
Close Background Processes: Shut down unnecessary applications to free up system resources on both devices.
Keep Applications Updated: Ensure Luna Display apps are running the latest versions.
Minimize Bluetooth Interference: Connect Bluetooth peripherals to the primary Mac and disable nearby devices that might affect performance.- Update
Applications: Ensure that both the desktop and client versions of the Luna Display app are updated to the latest version for optimal performance.
Why WiFi connections fail 🤔
Network setups vary widely, and several things can interfere:
Security software like antivirus, firewall, or VPN on your Mac/PC can block WiFi connections.
Router restrictions might disable Apple Bonjour (which Luna uses for device discovery) or prevent devices on the same network from talking to each other.
Ad-Hoc Networks have connection limitations due to Apple restrictions - results may vary based on your system specs.
Self-Assigned IP Issues: Configure static IP addresses for wired connections to resolve self-assigned IP problems. Assign unique IPv4 addresses within the same subnet and use the subnet mask 255.255.255.0.
Still stuck? Our support team can help troubleshoot your specific network setup! 💬


