CherryMusic is a Python music streaming server developed on Github.


  1. Connect to your slot through SSH

  2. Download the latest release of CherryMusic

     git clone -b master
  3. Start the configuration process. Port 12008 has been automatically generated for you, but you may use another 5 digit port between 10000 and 65535.

     screen -mS cherrymusic ~/cherrymusic/cherrymusic --setup --port 12008
  4. Open in your web browser

  5. Set the Media base directory option to /home/user/files or your chosen music directory. The rest can be left with default values.

  6. Click the Save Configuration and start CherryMusic button at the bottom of the page. The WebUI will refresh.

  7. You will be asked to enter an admin username and password. This account will have full control to create non-admin user accounts that can be used for friends/family.

  8. In SSH, hit Ctrl-a followed by d to detach from the CherryMusic screen window while leaving it running.


  • Click the menu in the top right corner to the options, including keyboard shortcuts. Admin users can also create new users and force an update of the music library.

  • Stop CherryMusic by entering pkill cherrymusic in SSH

  • Start CherryMusic again by entering screen -dmS cherrymusic ~/cherrymusic/cherrymusic in SSH

  • Upgrade CherryMusic by stopping CherryMusic then entering cd ~/cherrymusic followed by git pull in SSH

  • If you need to access your CherryMusic screen window, enter screen -r cherrymusic in SSH