- GitHub stars
- 4,428
- License
- MIT
- Latest release
- v3.2.1
26 August 2026 - Last commit
- 7 October 2026
- Runs on
- Docker, Ruby
Commits per month, last 12 months
83 commits
Replaces
Paid products Black Candy can stand in for.
How to self-host Black Candy
Black Candy runs on Docker and Ruby. The project's own install guide is the place to start; most people put it on a small server with Docker and a reverse proxy for HTTPS.
- Get a server: a home server, a VPS, or a managed app host.
- Install it the way the project's docs describe, usually with Docker Compose.
- Put it behind HTTPS and set up backups before you add real data.
- Update it regularly. Watch the project's releases.
Similar apps
- Navidrome Music Server
Modern Music Server and Streamer, compatible with Subsonic/Airsonic.
- koel
Personal music streaming server that works.
- Beets
Music library manager and MusicBrainz tagger (command-line and Web interface).
- Audiobookshelf
Audiobook and podcast server. It streams all audio formats, keeps and syncs progress across devices. Comes with apps for Android and iOS.
- Mopidy
Extensible music server. Offers a superset of the mpd API, as well as integration with 3rd party services like Spotify, SoundCloud etc.
- Snapcast
Synchronous multiroom audio server.
Questions
Is Black Candy free?
Yes. Black Candy is open source under the MIT license, so you can use it without paying for a license. You pay only for the server it runs on.
Can I self-host Black Candy?
Yes. Black Candy runs on Docker and Ruby. Follow the install guide in the project's documentation, or use a host that installs it for you.
What does Black Candy replace?
People use Black Candy instead of Spotify.
Is Black Candy still maintained?
The last change to Black Candy's code was on 7 October 2026, with 83 commits in the last 12 months.
Topics
App data from awesome-selfhosted (CC BY-SA 3.0), stars and activity from GitHub.