elstensoftware/bliss repository overview

⁠Quick reference

This is the official bliss Docker image, so it's maintained and supported here⁠.

⁠How to get help?

Send us an email or write us a letter.⁠.

bliss is software to organise music libraries. bliss makes your music library more browsable, searchable, playable and beautiful, whichever music players you use.

To run the current version of bliss, use this Docker run command:

docker run --rm --name bliss -d -u `id -u`:`id -g` -v ~/.bliss:/config -v ~/music:/music -p 3220:3220 -p 3221:3221 elstensoftware/bliss:latest

A short explainer about some of these options and parameters:

-u `id -u`:`id -g` is used to set the bliss user inside the Docker container to be the same as the user running the container. This is to avoid issues with file permissions, ownership etc.

-v ~/.bliss:/config mounts the ~/.bliss folder on the host into the bliss container, so settings and other runtime data can be persisted. If you don't do this, you'll lose your settings, licence and all scanned information on the next restart.

-v ~/music:/music mounts the ~/music folder on the host into the bliss container, so bliss can see your music library (or libraries). You could change this to, say, -v /Volumes/music:/music to mount an external music volume on a Mac, or -v /mnt/music:/music on Linux.

⁠Running a specific version of bliss

You can use the Docker tag to run a specific version:

docker run --name bliss -d -u `id -u`:`id -g` -v ~/.bliss:/config -v ~/music:/music -p 3220:3220 -p 3221:3221 elstensoftware/bliss:20240821

You should now be able to see the bliss UI: http://localhost:3220⁠ (replace localhost with the hostname if this is running on a different computer).

⁠Updating bliss with Docker

Updating is super-easy with Docker - just stop bliss, pull the latest image and restart:

docker stop bliss
docker pull elstensoftware/bliss:latest
docker run --rm --name bliss -d -u `id -u`:`id -g` -v ~/.bliss:/config -v ~/music:/music -p 3220:3220 -p 3221:3221 elstensoftware/bliss

⁠License

bliss has a free trial; you can fix 100 albums for free. However, after that you must pay. Please see the pricing details on the blisshq.com website⁠.