Skip to main content

WiFi Connection Issues — Troubleshooting

Luna Display should connect automatically when your devices are on the same WiFi network. If it's not connecting, here's how to fix it!

Updated this week

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:

  • iPad: Scan the QR code with your camera

  • Mac: Enter the numbers from section D

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! 💬

Did this answer your question?