How to Connect a Subsonic or Navidrome Server to Soundiiz – Soundiiz Support

SELF-HOSTED MUSIC

Connect your server

Use a secure public address for your Subsonic-compatible server, then transfer playlists and favorite music or keep playlists synchronized.

Before you connect

“Invalid credentials” often means “server unreachable”

If those credentials work on the server, check its address. Soundiiz runs in the cloud and cannot reach LAN, localhost, or Tailscale-only addresses.

You need:

A public HTTPS address that reaches your music server from outside your home network, including its port or base path when required.

The username and password created on your Subsonic-compatible server.

A reverse proxy, firewall, or Cloudflare rule that allows the server’s Subsonic interface to answer Soundiiz requests. See how to check blocked requests and allowlist Soundiiz.

Connect Subsonic or Navidrome

Choose the connector
In Soundiiz, select Navidrome for a Navidrome server or Subsonic for another compatible implementation.
Enter your server account
Use the username and password that work directly on that music server.
Enter the public server address
For example, use https://music.example.com. Include a non-standard port or configured base path when your server requires one.
Select Connect
Once the connection succeeds, the server appears with your other connected music services.

Which connector should you use?

Connector	Use it for
Navidrome	A Navidrome server.
Subsonic	Compatible servers such as Airsonic, Gonic, Funkwhale, Synology, Ampache, or Supysonic.

Soundiiz communicates using version 1.16.1 of the Subsonic interface. Compatibility still depends on which features each server implements, so a successful connection does not guarantee that every optional library action is available.

What can Soundiiz manage?

Transfer playlists to or from the server.

Transfer favorite music (tracks, albums, artists) when the server implements the corresponding Subsonic features.

Create a Sync to keep a source playlist and a destination playlist updated.

Syncs are for playlists only

Favorite music can be transferred when supported, but tracks, albums, or artists cannot be used as a Sync source or destination.

Explore the available transfer routes and tutorials on the Subsonic and Navidrome service pages.

Frequently Asked Questions

Why does Soundiiz say “Invalid credentials” when my password is correct?

The same message can appear when Soundiiz cannot reach the server or when a proxy blocks the connection. Test the public address outside your local network, then check your proxy or firewall logs, including Cloudflare.

Can I use a local IP address or Tailscale address?

No. Those addresses are available only inside your own network. Soundiiz needs a secure public address that reaches the server from the internet.

Can I connect two self-hosted servers?

You can use the Navidrome connector for one Navidrome server and the Subsonic connector for another compatible server. Each connector keeps its own connected account.

How many tracks can one playlist contain?

Soundiiz currently applies a limit of 10,000 tracks to Subsonic and Navidrome playlists. See the current playlist limits by music service.

Still unable to connect?

Send us the connector name, the public server address, the exact error, and what your server or proxy logged at that time. Never include your password.

Contact Support