Skip to content


What is it?

Beets catalogs your collection, automatically improving its metadata as it goes using the MusicBrainz database. Then it provides a bouquet of tools for manipulating and accessing your music.

Beets is a music library manager and not, for the most part, a music player. It does include a simple player plugin and an experimental Web-based player, but it generally leaves actual sound-reproduction to specialized tools.

Project home Docs Github Docker

1. Installation

sb install sandbox-beets

2. URL

  • To access Beets, visit https://beets._yourdomain.com_

3. Setup

  • The configured username/password are taken from your Saltbox accounts.yml file located in /srv/git/saltbox/accounts.yml
  • When the role is run, a cron job is set to automatically import any music found at /mnt/local/downloads/music every hour.
    If a match is under 95% beets will skip the file and it will need manual importing.
  • To run a manual import (which will help correct any matches under 95%) run the following command:

    rm /opt/beets/state.pickle && docker exec -it beets /bin/bash -c 'beet import /downloads'
  • If you want to change the folder structure you should do so in the config file located at
    This link details the allowed options

    If you already have imported music you will need to run an import using the following command:

    docker exec -it beets /bin/bash -c 'beet import /music'
  • Documentation