← Directory

Black Candy

Black Candy is a self-hosted music streaming server that turns your own music library into a personal music center.

  • Media Applications
  • Tools & Utilities
Black Candy is a self-hosted music streaming server that turns your own music library into a personal music center. It stores, organizes, and streams your tracks to any device, and ships mobile apps for iOS and Android, so homelabbers can listen to their own collection at home and on the go.

Platform availability

Available on 1 of 6 install platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)

Also on Docker Hub

Health score

77/100 Good

Maintained
100last commit 20 days ago
Popular
734,420 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

How is this calculated?

A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). Factors without data are left out and the rest are rescaled.

Availability: platform listings confirmed today

GitHub stars
4,420
Open issues
31
Last commit
2026-09-16
Latest release
v3.2.1
License
MIT
Activity
declining

Checked 7 days ago - source: GitHub (blackcandy-org/blackcandy)

Resources & Compatibility

Requirements not published yet.

Checked 7 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Permissions and first login Black Candy's container runs as UID/GID 1000:1000, so set ownership of your data directory before the first start (e.g., chown 1000:1000 /mnt/cache/appdata/blackcandy -R). After the first launch, log in with the default admin account: email [email protected], password foobar. source

Fetched today - each note links to its source

Alternatives (5)

  • Ampache - Ampache ...for the love of music You will need to follow the configuration steps here once the container is running: https://github.com/amp…
  • Funkwhale - Open-source, self-hosted streaming platform supports Android, iOS, podcasts, uploads, sharing, no ads or tracking, federated across decentr…
  • Navidrome - Modern Music Server and Streamer compatible with Subsonic/Airsonic
  • Plexamp - Plexamp is a small music player for your desktop, with a number of unique features.Throw your best FLACs at it and experience sonic bliss!.
  • Subsonic - Subsonic is a free, web-based media streamer, providing ubiquitous access to your music and video.

Checked 7 days ago - source: AlternativeTo

Common questions

What initial credentials should I use to log in to the web UI?

Use the initial admin account with email [email protected] and password foobar.

What ownership change is required for the application data directory?

The application directory must be owned by UID/GID 1000:1000, so chown it recursively to 1000:1000.

Are official mobile clients available?

Yes, an Android app is available on F-Droid and an iOS app is available on the Apple App Store.

Can multiple listeners use the same server?

Yes, Black Candy supports multi-user management so individual listeners can have personalized experiences.

Answers sourced from github.com, selfhostedhub.com

Community

Collected 6 days ago - public community threads