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.

[songdenkbar]

Hi scheilch,

first of all, thanks a lot for your work on this project — I really appreciate your open-source effort.

I have four speakers in the same network (same software version). Three of them were detected instantly. The fourth one is now being added afterwards, but it doesn’t show up.

• The device is recognized by the official SoundTouch app
• It’s reachable (curl http://:8090/info returns valid data)
• Configuration: host network. Other speakers were found instantly without manual input of IP.
• It can play music normally
• I already tried manual adding, but it doesn’t appear in the overview OCT
• Restarted everything and reinstalled the Docker container (newest version)
• I’m using Pi-hole. The other three devices work without issues

Any idea what could be causing this?

Thank you.