telep-tv disappears from AirPlay discovery after a uxplay restart even though both uxplay.service and avahi-daemon stay active — because uxplay’s avahi-compat layer doesn’t reliably re-register its mDNS records against a restarted/hiccuping avahi. Fix: restart avahi first, then uxplay.
For Agents
Host: telep-mainframe (
telep-mainframe, uxplay 1.71). Symptom string on devices:⚠ telep-tv nem látszik mDNS-en. Distinct from the avahi multi-interface / DHCP-flap / router AP-isolation causes in 2026-08-04-telep-mainframe-airplay-receiver-uxplay — here avahi itself is healthy (still advertises_nut._tcp, the HP printer), only uxplay’s_airplay._tcp/_raop._tcprecords are silently gone. Fix order matters: avahi → sleep 2 → uxplay.
Symptoms
- Devices show
⚠ telep-tv nem látszik mDNS-en(telep-tv not visible on mDNS). systemctl is-active uxplay avahi-daemon→ bothactive.avahi-browse -rt _airplay._tcpandavahi-browse -rt _raop._tcpreturn nothing for telep-tv.- Yet avahi still advertises other services (
_nut._tcp, the HP printer) → avahi itself is fine; only uxplay’s records vanished. - Observed 2026-08-30 after a uxplay restart at 21:56.
Root cause
uxplay (1.71) publishes its AirPlay/RAOP mDNS records via avahi-compat-libdnssd → avahi-daemon over D-Bus. Across a uxplay restart — or any avahi/D-Bus hiccup — the compat layer does not reliably re-register. uxplay keeps running, but its _airplay._tcp/_raop._tcp adverts are silently gone, so no device can discover the receiver.
Fix (order matters)
Restart avahi first, then uxplay, so uxplay registers against a fresh avahi:
sudo systemctl restart avahi-daemon
sleep 2
sudo systemctl restart uxplayRestarting uxplay alone can hit the same race
systemctl restart uxplayon its own re-registers against the same avahi instance and can silently fail to re-advertise again. Always bounce avahi first.
Verify
avahi-browse -rt _airplay._tcp # telep-tv@telep-mainframe AirPlay Remote Video @ 192.168.1.123:34625
avahi-browse -rt _raop._tcp # ...@telep-tv@telep-mainframe AirTunes Remote AudioBoth records back → re-open the AirPlay picker on the phone/Mac.
Related
- 2026-08-04-telep-mainframe-airplay-receiver-uxplay — full uxplay/telep-tv architecture; other AirPlay “not appearing” causes (avahi multi-iface, DHCP flap)
- airplay-telep-tv — the AirPlay incident runbook (this fix added under symptom (a))
- runbooks-index — all homelab runbooks
- telep-mainframe
- LOG · TOPICS