Documentation

Everything you need to get Black Candy Store running, configured, and shared across servers.

🚀

Installation

Get up and running with Docker in minutes.

⚙️

Configuration

Database, media paths, HTTPS, environment variables, and more.

🐳

Docker Compose Examples

Production-ready Compose files for common scenarios.

📚

Multiple Libraries

Organize your music into separate named libraries.

🔗

Cross-Server Sharing

Share libraries with other Black Candy servers using invite codes.

🎧

Playback Modes

Web player, AirPlay/Chromecast casting, and server-side output.

🎚️

Transcoding

Stream lossless files as compressed audio on the fly.

💿

Discogs Integration

Automatically fetch album and artist artwork.

📡

Media Clients (DAAP & RSP)

Expose your music to iTunes, Rhythmbox, and Roku devices.

⬆️

Upgrading

How to safely upgrade to new versions.