Workarounds for Subsonic’s remote connectivity & folder scanning bugs

Hi! Do you like nonexistent documentation? Then Subsonic is for you!


If you’re having trouble getting Subsonic to work, first ensure you’ve followed the Getting Started guide. If that fails – and it probably will due to Subsonic’s nonexistent documentation* – keep reading. This guide assumes your server is running fully patched Windows 8.1 August Update at the least, but it should also work for other versions of the OS.

Problem 1: you can’t connect to your custom server URL

If testing your custom server URL on the server within Subsonic’s web UI throws the is registered, but could not connect to it. (ConnectTimeoutException)

Try this:

  1. Open Control Panel.
  2. Click Windows Firewall.
  3. Click Allow an app or feature through Windows Firewall.
  4. In the window that pops up, click Change Settings, which may throw a UAC prompt depending on your settings for that latter feature. Confirm the UAC prompt.
  5. In the Allowed apps and features: list, scroll down to all the Subsonic entries and ensure that both Private and Public boxes are checked for all of them.
  6. Click OK.
You'll have to enable both Public and Private firewall exceptions for Subsonic.
You’ll have to enable both Public and Private firewall exceptions for Subsonic.

Your server should be now visible and pass connection tests. (Thanks squipple for this solution.)

Problem 2: Folder scanning fails

If you keep scanning a folder, only to find nothing from it shows up, that’s probably because the Subsonic Windows service doesn’t have permissions to access that folder. The service runs under the SYSTEM user, presumably to allow it to function even if someone else is logged in to the PC and the Subsonic admin isn’t. Unfortunately, SYSTEM lacks permissions to read every folder on your PC, probably including the ones you’re having trouble with.

There 2 ways to solve this problem:

Solution 1: run the Subsonic service under your user account

  1. Open Services in Windows.
  2. Scroll down to find the Subsonic service.
  3. Right-click the Subsonic service.
  4. Click Properties.
  5. Click the Log On tab.
  6. Activate the This account: radio button.
  7. In the This account: field, enter .\YourWindowsUsername.
  8. Enter and confirm your Windows OS password in the remaining 2 fields.
  9. Click Apply.
  10. Click OK.
Set the Subsonic service to run under your user account.
Set the Subsonic service to run under your user account.


  • This is a global setting that gives the service access to every folder you have access to. You only have to set it once.


  • As far as I know, it’s unusual for services to run as a user (I’ve never had to do that before). This may lead to other complications of which I’m not yet specifically aware. I suspect it may result in the service not running if the corresponding user isn’t currently logged in to the server PC.

Solution 2: change the folder’s security settings

  1. In Windows Explorer, right-click the folder.
  2. Click Properties.
  3. Click the Security tab.
  4. Click Edit…
  5. Click Add…
  6. In the Enter object names to select field, enter Everyone. You probably could use SYSTEM or groups other than Everyone which contain Everyone but I didn’t test those so I’m not sure if they work.
  7. Click Check Names.
  8. Assuming the check is successful, click OK.
  9. Click OK.
  10. Click Apply.
  11. Click OK.
  12. In the Permissions for Everyone section, ensure all permissions except Special Permissions are set to Allow. If they aren’t, click Advanced to make them so.
  13. Click Apply.
  14. Click OK.
What your folder permissions should look like.
What your folder permissions should look like.

Once you’re done with either of the above methods:

  1. Return to the Subsonic UI.
  2. Click on Settings.
  3. Check the Delete box and clear the Enabled box next to the troublesome folder.
  4. Click Save.
  5. Click the Clean-up database link.
  6. Click the Scan media folders now link.
  7. When the scan completes, re-add the problem folder.
  8. Click the Scan media folders now link again.

Files from the problem folder should show up now.


  • No unusual Windows service settings.


  • Has to be set per individual parent folder.
  • Messes with pre-existing folder permissions, which may result in giving access to users you don’t want to give access to.

(Thanks to Subsonic developer Sindre Mehus for Solution 1.)

*Yes, Subsonic does have some documentation. But despite the above 2 issues being very common in the user forum, there’s no page or even forum sticky post for solving them. That’s pretty bad for a paid service, especially considering that Audiogalaxy worked perfectly out of the box with the same (music) features.

Author: jdrch

ISTJ, Rice Owl, UF Gator, mechanical engineer. STEM, sports, music, movies, humor. Account mine only & unaffiliated.


Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s