Black Candy

Self-Hosted

Open-source self-hosted music streaming server

Overview

Black Candy is an open-source, self-hosted audio streaming server for managing and streaming your personal music library. It organizes tracks by metadata (artist, album, genre) and offers a clean web interface for browsing and playback. Supports streaming to multiple devices and uses Docker for simplified deployment, accessible to users with basic server knowledge. Prioritizes privacy by keeping your collection under your control, no third-party services involved. Ideal for music lovers wanting to access their library anywhere without relying on proprietary platforms.

Self-Hosting Resources

Find Official Image on Docker Hub View Source & Docs

Below is a reference structure for docker-compose.yml. ⚠️ Do NOT run blindly. Replace placeholders with official values.

docker-compose.template.yml TEMPLATE


version: '3'
services:
  black_candy:
    image: <OFFICIAL_IMAGE_NAME>:latest
    container_name: black-candy
    ports:
      - "8080:<APP_INTERNAL_PORT>"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

Key Features

Organizes music via metadata (artist, album, genre)
Clean web interface for browsing and playback
Docker-powered deployment for easy setup

Frequently Asked Questions

? Is Black Candy hard to install?

Black Candy is easy to install using Docker. With pre-built images and Docker Compose support, you only need to mount your music directory and configure basic settings (like port) to get it running—ideal for users with minimal server experience.

? Is it a good alternative to Spotify?

Black Candy is a great alternative if you want full control over your music library. Unlike Spotify, it streams your personal collection instead of a curated catalog, making it perfect for users who own their music and prioritize privacy over mainstream content.

? Is it completely free?

Yes, Black Candy is 100% open-source and free to use. There are no paid tiers or subscription costs—you only cover hosting expenses if using a remote server.

Top Alternatives

Spotify Compare

Apple Music Search Google

Tool Info

Pricing Open Source

Category Media Streaming - Audio Streaming

Platform Self-Hosted

Pros

⊕ Privacy-focused (self-hosted, no third-party access)
⊕ No subscription fees
⊕ Simple to deploy with Docker Compose

Cons

⊖ Requires a server or hosting environment
⊖ Limited to personal music library (no mainstream catalog)
⊖ Minimal advanced features compared to SaaS platforms