beets

2.14.1-ls356

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.

Music

docker pull lscr.io/linuxserver/beets:latest

Quick start

Generated from the image's own configuration. Replace the /path/to folders with real paths on your host.

---
services:
  beets:
    image: lscr.io/linuxserver/beets:latest
    container_name: beets
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/beets/config:/config
      - /path/to/music/library:/music
      - /path/to/ingest:/downloads
    ports:
      - 8337:8337
    restart: unless-stopped

Parameters

Ports
Port	Function	Required
8337:8337	Application WebUI	required

Environment variables
Variable	Function	Required
PUID=1000	User ID	required
PGID=1000	Group ID	required
TZ=Etc/UTC	Timezone	required

Volumes
Path	Function	Required
/config	Persistent config files	required
/music	Music library	required
/downloads	Non processed music	required

Architectures

Pulling :latest picks the right one for your host automatically.

x86_64amd64-latest
arm64arm64v8-latest

Changelog

1 Feb 2026
Rebase to Alpine 3.23.
27 Jan 2025
Rebase to Alpine 3.21.
1 Oct 2024
Add packages required for Discogs plugin.

Writing

Posts about beets

8 Oct 20168 min read

Managing your music collection with beets

Any audiophile will attest to compiling albums well into the hundreds, or even thousands. When a music collection grows, it can become harder to keep it well managed. The main…

Browse all

jellyfin

12.3ubu2604-ls56

jellyfin is a Free Software Media System that puts you in control of managing and streaming your media. It is an alternative to the proprietary Emby and Plex, to provide media from a dedicated server to end-user devices via multiple apps. Jellyfin is descended from Emby's 3.5.2 release and ported to the .NET Core framework to enable full cross-platform support. There are no strings attached, no premium licenses or features, and no hidden agendas: just a team who want to build something better and work together to achieve it.

8.2M906arm64

plex

1.43.5.11029-6bf8af3f0-ls329

plex organizes video, music and photos from personal media libraries and streams them to smart TVs, streaming boxes and mobile devices. This container is packaged as a standalone Plex Media Server. Straightforward design and bulk actions mean getting things done faster.

7.6M1.4Karm64

lidarr

3.1.0.4875-ls45

lidarr is a music collection manager for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new tracks from your favorite artists and will grab, sort and rename them. It can also be configured to automatically upgrade the quality of files already downloaded when a better quality format becomes available.

6M316arm64

emby

4.10.2.0-ls304

emby organizes video, music, live TV, and photos from personal media libraries and streams them to smart TVs, streaming boxes and mobile devices. This container is packaged as a standalone emby Media Server.

2.2M150arm64