# CherryMusic

CherryMusic is a self-hosted music streaming server written in Python that lets you stream your local music collection to any device with an HTML5-compatible browser. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1496/cherrymusic

## Description

CherryMusic is a self-hosted music streaming server written in Python that lets you stream your local music collection to any device with an HTML5-compatible browser.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

8/100 (Low), based on 3 of 4 factors.
- Maintained: 0 (last commit 1455 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/pinion/cherrymusic
- GitHub: https://github.com/noinip/cherrymusic
- Unraid: https://ca.unraid.net/apps/cherrymusic-1m3jes90s0hb31?q=CherryMusic

## Common questions

### How do I run CherryMusic in Docker with the right port and volume mounts?

Run the container with host port 8070 mapped to container port 8070. Mount a host config directory to /root/.config/cherrymusic and your music library to /music. You can also mount /etc/localtime read-only for timezone handling.

### Does CherryMusic come with its own daemon, and how do I run it as a service on Arch?

CherryMusic does not include a daemon, but the AUR packages provide a systemd service file. Start it as cherrymusic@user.service, where user is the account that should run CherryMusic, and do not use root.

### Does CherryMusic require a database or large KDE dependencies to install?

No, CherryMusic is designed to keep the dependency count low. Cherrypy is the only non-optional dependency, avoiding the need for a database or large KDE dependencies.

### Can CherryMusic 0.29.0 stream MP3 files to clients?

Yes, the 0.29.0 release notes state that it streams MP3 music to clients.

---
Source: Our Local Host (https://ourlocalhost.com/app/1496/cherrymusic), the self-hosted and open-source app directory.
