Black Candy

Host your own music streaming server using Docker. Manage media files, integrate with Discogs for album art, and listen on the go with dedicated mobile apps.

Take full control of your audio library by hosting a personal music streaming center. This self-hosted server allows you to bypass third-party subscriptions and keep your media files entirely private while still enjoying a modern listening experience. With straightforward Docker deployment, you can quickly map your local media directories and start playing your favorite tracks across all your devices.

Key features include:

  • Flexible database options: Run the server using the default SQLite for quick setups, or switch to PostgreSQL for larger, cloud-hosted libraries.
  • Dedicated mobile apps: Access your music on the go using native applications available for both iOS and Android platforms.
  • Discogs API integration: Automatically fetch high-quality artist images and album art to keep your library visually organized.
  • Customizable storage: Easily mount media files from your host machine and persist data securely using simple volume configurations.

Directory Structure

black-candy
db_data
music
.env
docker-compose.yml

docker-compose.yml

services:
  web:
    image: blackcandy/blackcandy:latest
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - RAILS_ENV=production
      - RAILS_LOG_TO_STDOUT=true
      - DB_URL=postgres://blackcandy:${POSTGRES_PASSWORD}@db:5432/blackcandy
      - SECRET_KEY_BASE=${SECRET_KEY_BASE}
    depends_on:
      - db
      - redis
    volumes:
      - ./music:/app/public/music

  db:
    image: postgres:15-alpine
    restart: unless-stopped
    environment:
      - POSTGRES_USER=blackcandy
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=blackcandy
    volumes:
      - ./db_data:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine
    restart: unless-stopped

.env

POSTGRES_PASSWORD=secure_database_password
SECRET_KEY_BASE=generate_a_long_random_secret_string_here
Categories:

Share:

Ad
Favicon

 

  
 

Similar to Black Candy

Favicon

 

  
  
Favicon

 

  
  
Favicon