My speaker isn't found — how do I troubleshoot discovery?

[scheilch]

Discovery Troubleshooting

If OCT can't find your SoundTouch speaker, try these steps in order:

1. Check Network

Both OCT and your speaker must be on the same network (same subnet). If OCT runs in Docker, use --network host mode — this is critical for SSDP multicast discovery.

docker run --network host ...

2. Add Manual IP

If SSDP discovery fails (common on certain routers), add the speaker's IP manually:

1. Find your speaker's IP in your router's DHCP table
2. Go to OCT → Settings → Manual IPs
3. Add the IP address
4. Click Discover

3. Check Firewall

SSDP uses UDP port 1900 (multicast). Make sure your firewall allows it:

# Linux
sudo ufw allow 1900/udp

# Windows — see docs/TROUBLESHOOTING.md for firewall rules

4. WSL2 Users

If you're running Docker in WSL2, multicast requires additional configuration:

• Set networkingMode=mirrored in .wslconfig
• Add Windows Firewall rule for UDP ports 1900, 5353
• Use rootful Podman mode if using Podman

See WSL2 Troubleshooting for detailed instructions.

5. Verify Speaker is Online

Your speaker should have a static or DHCP-assigned IP. Try pinging it:

curl http://<speaker-ip>:8090/info

If this returns XML, the speaker is reachable and OCT should find it.

---

Still stuck? Post your setup details (OS, Docker version, network config), and we'll help debug.