Black Candy
Black Candy runs a self-hosted music streaming server for listening to a personal music collection.
About Black Candy
Black Candy is a self-hosted music streaming server for listening to a personal music collection. It runs from a Docker image and is accessed in a browser, with mobile apps also offered.
Media files are mounted from the host with the MEDIA_PATH variable, persistent data is stored in /rails/storage, and SQLite is used by default with PostgreSQL as an option. The public demo does not include administrator privileges, and upgrades may include breaking changes.
Key features
- Stream a personal music collection from a self-hosted server
- Install via Docker image from GHCR or Docker Hub
- Mount host media directory using MEDIA_PATH variable
- Use SQLite by default with optional PostgreSQL database
- Persist data by mounting /rails/storage directory
- Mobile apps available including Android APK from releases
Best for: People who want to host and stream their own music collection on their own server.
Good for
- Open-source codebase available on GitHub
- Docker images published on GHCR and Docker Hub
- Public demo available with music from Free Music Archive
Watch out for
- Demo account lacks administrator privileges, limiting feature testing
- Upgrades may include breaking changes requiring review of upgrade guide
Black Candy at a glance
- Category
- Software & Utilities › Media Players & Servers
- Type
- Open-source project
- Pricing
- Not confirmed. Check the site
- Open source
- Yes · Source code
- Language
- English
- Last checked
- Oct 5, 2026 · Online when checked
- Listed
- Oct 5, 2026
Guides for Media Players & Servers
Black Candy alternatives
Tools and sites you could use instead, ranked by how closely they match.
Kyoo runs as a self-hosted server for movies, series, and anime, with automatic scanning and metadata matching.
Open source
24 alternatives
Homehost streams a personal collection of movies, TV shows, and music across a home network as a self-hosted app.
Open source
24 alternatives
Streama offers a self-hosted streaming media server, with setup instructions and documentation linked from the project.
Open source
24 alternatives
Feishin provides a modern client for playing music from self-hosted services.
Open source
24 alternatives
Swing Music is a self-hosted player for local audio files, according to its project description.
Open source
24 alternatives
Run a self-hosted virtual browser in Docker with Neko, which uses WebRTC.
Open source
24 alternativesPopular in Media Players & Servers
Well-known listings from the same topic.
Ampacheampache.orgAIMPaimp.ruXbox Kodiapps.microsoft.com/detail/9nblggh4t892Pasta Toolpastatool.comMuseeksmuseeks.ioCaracal Clubcaracal.club
Black Candy FAQ
How can I try Black Candy without installing it?
Visit https://demo.blackcandy.org and log in with email [email protected] and password foobar. The demo account does not have administrator privileges and uses music from Free Music Archive.
How do I install Black Candy with Docker?
Run docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest or docker run -p 80:80 blackcandy/blackcandy:latest, then open http://localhost or http://host-ip and log in with the initial admin user.
Can I use PostgreSQL instead of the default database?
Yes. SQLite is used by default, and PostgreSQL can be used by setting DB_ADAPTER and DB_URL environment variables.
Is something wrong or out of date?
Tell us and an editor will check it.
Own this website?
Claim this listing
Claim the listing and suggest updates yourself. An editor checks every claim first.