Sonos troubleshooting ​

Troubleshooting issues with the Sonos integration and how to resolve them.

Table of contents

Cloud connection states ​

The Sonos Settings screen shows one of four status badges:

• Cannot Connect to Service - could not establish connection with our service for Sonos. Check your internet connection if problem persists contact support@1home.io
• Not Linked — no Sonos account is linked yet, or the account has been unlinked. Click Link Sonos Account to authorize.
• Linked — authorization succeeded and 1Home is talking to the Sonos cloud. Playback state, volume, and group membership should be in sync.
• Disabled — the Sonos integration is linked but not currently running. This shouldn't normally happen; click Restart to re-enable it.

When to click Restart ​

Use Restart on the Sonos Settings screen when:

• The playback state becomes de-synced or is not updating (a player shows "Idle" when it is actually playing, or vice versa).
• A player appears greyed out even though it is powered on and visible in the Sonos app.

Restart re-establishes the connection to the Sonos cloud without touching your linked account. Your imported players, rooms, and KNX mappings are preserved.

When to unlink and re-link ​

Use Unlink Account when:

• You want to switch to a different Sonos account.
• You have changed the Sonos password and 1Home can no longer authenticate — try Restart first; if that fails, unlink and link again.
• The Linked state gets stuck in an unrecoverable authentication loop.

A player is missing from "Newly Detected Players" ​

The Newly Detected Players table during setup only shows speakers that are not yet imported. If a player you expected is missing:

• It may already be imported. Check the Devices list in 1Home; if the player is there, there is nothing to do.
• It may belong to a different Sonos household than the one you selected in the setup flow. Go back one step and pick the other household.
• It may be offline or unreachable in the Sonos app itself. Check that speaker has internet connection and is plugged in.

Known limitations ​

• Cloud connection is required. The integration talks to the Sonos cloud; it does not fall back to the local network. If your 1Home Server or your Sonos speakers lose internet access, control pauses until connectivity is restored.
• S1-only households cannot be linked. See Supported devices.