App Guides

Subsonic on a Seedbox: Self-Hosted Music Streaming

Subsonic is the long-running self-hosted music server. Stream your library to anywhere, well-supported by mobile clients. Here's how it works on Bytesized.

What Subsonic Is

Subsonic is a self-hosted music streaming server. Point it at a folder of music, and it presents that library to web browsers, mobile apps, and even Sonos speakers. It transcodes on the fly so a FLAC library plays cleanly on a phone over LTE.

It's been around since 2004 and has been forked into Airsonic, Madsonic, and Navidrome along the way. The original Subsonic is still actively maintained and is what Bytesized ships.

Why Run It on a Seedbox?

Music libraries are big and listening happens everywhere:

Subsonic vs Alternatives

Quick reality check before installing:

If you want a deep music app with broad mobile app support, Subsonic is the easy pick.

Installing Subsonic

Open the Bytesized Panel, find Subsonic in the app catalog, click install. The panel sets up the binary, the reverse proxy, and gives you a clean HTTPS URL.

Click "Open" to land on the dashboard.

First-Run Setup

  1. Sign in. Default admin credentials are in the app's settings page in the panel; change them on first login.
  2. Add a music folder. Settings > Media folders. Standard Bytesized layout is ~/files/music.
  3. Start the scan. First scan can take a while on big libraries. The library is usable while the scan is running.

Subsonic reads ID3 tags by default. If your tags are clean, the library looks clean. If they're messy, run them through MusicBrainz Picard before pointing Subsonic at the folder.

Mobile Apps

Subsonic doesn't ship an official mobile app, but the Subsonic API has been the de-facto standard for self-hosted music for over a decade. Plenty of clients available:

Each has trade-offs around offline sync, gapless playback, and UI. Try a couple; pick one. They all sign in with the same Subsonic URL and credentials.

Transcoding

Subsonic transcodes on demand so a FLAC library plays on bandwidth-constrained mobile data. Defaults are sensible. If you want to tune:

Transcoding eats a little CPU. On a Bytesized slice this is rarely an issue unless you have lots of concurrent streamers.

Sharing

Subsonic supports shareable links for individual albums or playlists. Useful for sending someone a track without giving them an account.

Premium subscribers get more share controls (passworded shares, expiry dates). Free Subsonic supports basic shares.

Common Gotchas

Library scan finds nothing. Almost always permissions or wrong folder path. The path Subsonic shows is relative to the slice's home directory.

Mobile app can't connect. Use the full HTTPS URL from your panel. Some older Subsonic clients want a username/password rather than a token; both work.

Album art missing. Subsonic reads embedded album art from ID3 first, folder.jpg second. If neither is present, no art shows. Picard can embed art automatically.

Transcoding stuck. Check the Subsonic logs from the panel. Most often the source file has a corrupt header; remux through ffmpeg fixes it.

FAQ

Is Subsonic free? Free with limits. Premium (~USD 1/month or USD 12/year) unlocks Sonos integration, podcast features, and a few cosmetic things. Most users do fine on free.

Will it work with my existing music files? Yes. Point it at the folder, scan, done. ID3-tagged FLAC, MP3, M4A, OGG all work.

Can I use it with Sonos speakers? Yes, with a Premium subscription.

How does it compare to Plex for music? Better. Subsonic is music-first; Plex's music UI feels like a slightly orphaned afterthought.

Can multiple people have separate playlists? Yes. Per-user accounts; everyone has their own playlists, ratings, listening history.

Ready to Set It Up?

Browse Appbox plans, pick one with the storage your library needs, install Subsonic from the panel.

15+ years of seedbox hosting 5.0/5 Trustpilot (248 reviews) 61+ one-click apps

Ready to Get Started?

Set up your own media server in under two minutes.