All templates

Deploy BlackCandy on your own server.

BlackCandy logo

BlackCandy is a self-hosted music streaming server built with Rails and Hotwire. It provides a clean, modern web interface for streaming your personal music collection. The goal of the project is to create a real personal music center that you can access from anywhere. It features mobile apps for iOS and Android, supports multiple audio…

Your infrastructureAutomatic HTTPSNo lock-in

Screenshots

A closer look at BlackCandy.

BlackCandy screenshot 1

Setup time

A few minutes

Deployment

Your own server

Services

1 connected service

Why BlackCandy

Everything you need, running where you choose.

Get the full BlackCandy experience with Easypanel handling the repetitive infrastructure work around it.

Modern Web Interface
Clean and intuitive web interface built with Rails and Hotwire, providing a smooth and responsive music browsing experience.
Multiple Database Support
Supports both SQLite (default) for simple setups and PostgreSQL for more demanding installations or cloud deployments.
Data Persistence
All data is stored in `/app/storage` for easy backup and persistence across container updates and restarts.
Discogs Integration
Optional integration with Discogs API to automatically fetch artist and album artwork for your music collection.
Demo Mode
Built-in demo mode for testing and showcasing features without giving users administrative privileges.
Customizable Deployment
Flexible configuration options including custom ports, media paths, database options, and SSL enforcement.
How it works

From template to live app in three steps.

Easypanel turns the template into real services, storage, and domains on the server you already control.

Already have Easypanel? Open your dashboard at the URL or IP of your own installation.

Installation guide
1
Open your dashboard
Visit the URL or IP of your Easypanel installation and choose the target project.
2
Choose BlackCandy
Open Templates, select BlackCandy, then review its service names and configuration.
3
Deploy and open your app
Easypanel starts every service and provisions an HTTPS domain for you.
Installation options
The template asks for these values before creating your services.
OptionDefaultRequired

App Service Name

blackcandyRequired

App Service Image

BlackCandy Docker image

blackcandy/blackcandy:3.1.0Required

Media Path

Path to your media files

/tmpRequired
Resources
Project documentation and source code.
Latest template update
Jun 26, 2025

Initial Template Release

Questions

Deploy with confidence.

The template handles the application setup while Easypanel keeps the infrastructure understandable and under your control.

Keep exploring

Related templates

Browse all
Swingmusic logo
Swingmusic
Swingmusic is a beautiful, self-hosted music player and streaming server for your personal music collection. It provides a modern, intuitive web interface that allows you to stream your music library from anywhere. With support for various audio formats and a clean, responsive design, Swingmusic makes it easy to enjoy your music collection across all your devices. The application offers features like playlist management, search functionality, and album artwork display, making it a perfect alternative to commercial streaming services for those who want to keep their music library private and under their control.
View template
Airsonic Advanced logo
Airsonic Advanced
Airsonic Advanced is a more modern implementation of the Airsonic fork with several key performance and feature enhancements. It's a free, web-based media streamer providing ubiquitous access to your music. Use it to share your music with friends, or to listen to your own music while at work. You can stream to multiple players simultaneously, for instance to one player in your kitchen and another in your living room. It supports very large music collections and works with any audio or video format that can stream over HTTP.
View template
Podfetch logo
Podfetch
Podfetch is a self-hosted podcast manager and aggregator that allows you to subscribe to, download, and organize your favorite podcasts from a single centralized interface. It automatically fetches new episodes from RSS feeds at configurable intervals, stores podcast metadata and audio files locally, and provides a web-based interface for browsing and managing your podcast library. The application features automatic episode downloading, customizable polling intervals for checking new content, SQLite database for lightweight data management, and organized file storage for podcast episodes. With its built-in audio player, you can stream episodes directly from the web interface without needing external podcast clients. Podfetch supports multiple podcast subscriptions, episode filtering, playback progress tracking, and automatic cleanup of old episodes to manage storage. The Rust-based backend ensures efficient performance and low resource usage, making it ideal for running on home servers or low-powered devices. Perfect for podcast enthusiasts who want complete control over their podcast library, users seeking privacy and independence from commercial podcast platforms, home lab administrators building media server ecosystems, or anyone who wants to archive and organize podcast episodes without relying on third-party services or dealing with platform-specific limitations.
View template
BlackCandy logo
Ready to deploy BlackCandy?
Open your own Easypanel dashboard, choose BlackCandy from Templates, and review the deployment options.