Black Candy
Turn your music collection into a personal Spotify-like service with official mobile apps.
Smart Download
Visit Project Homepage
No installer available yet — head to the source repository
One-command Docker deployment for a private, app-supported music streaming server.
Core Features
- One-line Docker deployment, zero config
- Official iOS & Android apps via App Store and F-Droid
- Dual database support: SQLite (default) or PostgreSQL
- Mount media directory and auto-scan
- Responsive web UI with mobile-friendly design
What It Can't Do
- •Default SQLite is fine for small libraries; switch to PostgreSQL for >5000 tracks,Always read the upgrade guide before updating; breaking changes may occur,Persist /app/storage directory to avoid data loss on container restart,Set SECRET_KEY_BASE environment variable to keep sessions alive across reboots
Use Cases
- Self-hosted music cloud for family and friends
- Privacy-first alternative to commercial streaming services
- Sync playback across multiple devices seamlessly
Black Candy is a self-hosted music streaming server designed for individuals and families. It lets you upload or import your music library, stream it from any device via a web browser or dedicated mobile apps (iOS and Android), and manage playlists, albums, artists, and genres. The server is packaged as a single Docker image for effortless deployment, with SQLite as the default database (PostgreSQL optional). Features include user authentication, media file mounting, background job processing, and simple configuration via environment variables. Its mobile apps are available on the App Store and F-Droid, providing a seamless listening experience without relying on third-party cloud services.
Tags
Getting Started
Download installer
Click the button above to download the installer for your system
Install the software
Double-click the downloaded installer and follow the prompts
Step 1: Run docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest
Step 2: Open http://localhost in browser, login with admin@admin.com / foobar
Step 3: Add your music path in settings or upload files via web UI
- Step 1: Run docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest
- Step 2: Open http://localhost in browser, login with admin@admin.com / foobar
- Step 3: Add your music path in settings or upload files via web UI
Checksum not available
This project has not published a SHA-256 checksum on its GitHub Release page
SHA256 Checksum
No checksum available
Download directly from GitHub Releases and verify file integrity yourself
All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.
Open Source Transparency
View GitHub SourceUninstall Info
Stop and remove container, then delete any mounted data directories (e.g., storage_data) to fully uninstall.
No Extra Dependencies
Ready to use after download. No additional runtime required.
Having issues? Check the FAQ below
5 FAQs
Similar Projects
Huginn
Huginn lets you build agents that automate online tasks. Events propagate through a directed graph. Monitor web, Twitter, email, and more.
RSSHub
RSSHub is the world's largest open-source RSS network. It generates RSS feeds from virtually any website, with over 5,000 instances and a thriving community. Perfect for aggregating social media, news, blogs, and more.
Puter
An open-source internet computer that lets you access all your files, apps, and games from anywhere, with self-hosting for full control.