Troubleshooting guide

Sunshine Host Not Found: Fix Moonlight Discovery Before Pairing

Category: Game Streaming

You are on the Moonlight client, expecting your Sunshine host to appear, but the list stays empty and pairing is impossible. This is a discovery failure, not a streaming failure, so work through it in order.

Confirm the host is actually advertising

On the Sunshine machine, open the web UI and check that Sunshine is running and that its status is active. Then confirm the host and client are on the same subnet. If Sunshine is bound to a specific interface, switch it to the interface your client uses, or verify the advertised address matches that subnet. A host on 192.168.1.x will not be discovered by a client on 192.168.2.x without manual entry.

Check firewall and discovery traffic

Sunshine uses mDNS for automatic discovery. On the host, allow Sunshine through the firewall for both private and public profiles if needed, and confirm UDP 5353 is not blocked. On the client, disable any VPN or guest-network isolation temporarily. If the host appears only after you manually add its IP in Moonlight, discovery traffic is being filtered, not the stream itself.

Interpret the result precisely

If the host appears after manual IP entry, the fix is network filtering or interface binding. If it still does not appear, Sunshine is not listening on the expected address or the client cannot route to it. Test with a ping from client to host; a reply confirms routing, while a timeout points to subnet or firewall issues. This is the controlled diagnosis that separates a sunshine host not found symptom from a pairing or encoder problem.

Verification test

Restart Sunshine, then refresh Moonlight’s host list. The host should appear within about 30 seconds without manual entry. Pair once and confirm the PIN prompt completes.

Rollback and recovery

If changes break streaming, revert the interface binding and firewall rule you last edited, then re-add the host by IP in Moonlight so you retain a working path. For deeper help,

A Windows gaming PC with Sunshine and a Moonlight client showing stream settings

Ask for help.


Back to the service page · Ask about this exact symptom