Beets Music Management: Docker & Portainer Guide

Welcome!
I struggled with Beets setup and wanted to share my configs, tips, and troubleshooting for anyone else working on music management with Docker and Portainer.

Quick Start

Tested On:

Debian 12
Docker
Docker Compose (optional, for Portainer stacks)
Portainer Business Edition (optional; note: can be buggy with stuck containers/stacks)

Note:
Replace anything marked (redacted) with your own API keys.

How I Use Beets

Most configs and example files are well-commented—please read through them first!
I use Lidarr arr-scripts to manage my music library.
This setup is still in testing phase, but works without damaging your library.

Help & Community

Discord: Join for help or discussion
Issues: Feel free to open an issue with questions or suggestions.

Unsolved Problems

Spotify as Only Indexer:
After running for a while, only Spotify shows up as an indexer, even with DNS access to MusicBrainz. Is this a block?
Would prefer Beets to stop if it can't reach all indexers, to ensure best results.
Multi-Indexer Genre Combining:
How to combine genres from multiple sites instead of using just one?
WLG is broken—could submit a PR for a better method.
Exporting Lyrics (.lrc):
Want to export to .lrc for Navidrome/Plex lyric support.
Currently, only .pdf export is available.

Tips

Read through all config files for comments and explanations.
Use Docker Compose for easier stack management, but be aware of Portainer quirks.
Always backup your music library before testing new configs.

Happy tagging and organizing!

1.8 KiB Raw Blame History