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 over a month ago

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

Try these solutions

  • Restart everything: Restart both your primary device and secondary device, plus your router

  • 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)

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.

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.


Still stuck? Our support team can help troubleshoot your specific network setup! 💬

Did this answer your question?