A detailed tutorial for adding Sonos products on Home Assistant 2025.12.2+. The content has been verified against the latest version logic, so even beginner users can complete the configuration smoothly.
🟢 Preparation (must read)
Before starting, please make sure the following 3 core conditions are met; otherwise Home Assistant (HA) may not find your Sonos speakers:
- Same local network: your Home Assistant host (such as a Raspberry Pi or soft router) must be connected to the same router/same subnet as the Sonos speakers.
- Note: if your HA runs in Docker or a virtual machine, make sure the network mode is
Sonos device online: make sure your Sonos speakers have already been configured in the official app and can play music normally.
Enable UPnP (key step):
- Open the Sonos app on your phone.
- Go to Settings -> Manage -> System Settings (the path may vary slightly between app versions, but it is usually under account/privacy or network settings).
- Find and enable the UPnP option. This allows HA to discover the speakers automatically.
🚀 Tutorial: Adding Sonos in Home Assistant
Method 1: Automatic discovery (simplest, recommended)
Home Assistant 2025.12 has a very well-optimized auto-discovery feature; usually you just need to log into the backend to see the prompt.
- Log into the HA backend.
- Check Settings in the left menu bar; if a blue badge appears, a new device has been discovered.
- Click Settings -> Devices & Services.
- At the top you will see the Discovered area, which should show Sonos.
- Click the blue Configure button.
- Click Submit.
- The system will configure all speakers automatically and then prompt you to assign them to specific rooms (such as living room or bedroom). Click Finish when done.
Method 2: Manual add (if nothing pops up automatically)
If Sonos does not appear under Discovered, follow these steps to add it manually:
- Click Settings in the HA left menu.
- Select Devices & Services.
- Click the blue + ADD INTEGRATION button in the bottom right corner.
- Type Sonos in the search box.
- Click the Sonos icon in the search results.
- The system will try to automatically search for devices on the local network:
- Case A: it finds them; just click Submit (see the steps in method 1).
- Case B: if it asks for a Host (host/IP), you need to enter the IP address of any one of your Sonos speakers.
- How to check the IP? You can find it in your router admin panel or under About My System in the Sonos app (for example 192.168.1.100).
After entering the IP, click Submit and HA will use this device to find all your other Sonos devices.
✅ Verification and usage
After a successful add, we need to verify the devices work and add them to the dashboard.
- Confirm device status:
- Go back to Settings -> Devices & Services and find the Sonos card.
- Click Devices and you should see a list of all the Sonos speakers in your home.
Add to the Dashboard:
- Click Overview in the left menu (or your custom dashboard).
- Click the pencil icon (Edit Dashboard) in the top right corner to enter edit mode.
- Click + ADD CARD in the bottom right corner.
- Search for Media Control or look directly for Media Player.
- In the Entity dropdown, select your Sonos speaker (for example media_player.living_room).
- Click Save.
Now you can control Sonos playback, pause, volume adjustment and multi-speaker grouping directly from the HA home page.
💡 Advanced tips (based on new 2025.12 features)
In Home Assistant 2025.12, building automations has become much more intuitive. You can try the following simple automation:
Scenario: play music automatically when you get home
- Go to Settings -> Automations & Scenes -> + Create Automation.
- Trigger (When): select State, choose your phone’s location entity (such as person.your_name), and set the state changing from away to home.
- Action (Then):
- Search for and select Media Player.
- Select the Play Media action.
- Select your Sonos speaker.
- In Content ID, enter the URL of the radio station you want to listen to, or a simple playback command.
- (An even simpler approach): select the Media Player: Turn on action; Sonos will usually resume the last played content.
❓ Common troubleshooting
- Q: What if the device cannot be found?
- A: 90% of the time it is a network issue. Restart the router, the Sonos speakers and the Home Assistant host. Make sure HA is not blocked by a firewall on UDP port 1900 (this is the discovery protocol).
Q: The entity shows Unavailable?
- A: Check whether the Sonos is powered off or offline. If this is a Docker-based HA, confirm again that the container network mode is host.
Q: Does TTS (text-to-speech) work?
- A: Yes. Sonos fully supports HA’s TTS. In Developer Tools -> Actions, search for tts.speak or tts.google_translate_say (depending on the TTS service you configured), select the Sonos entity and it will speak, for example “the laundry is done”.
