jojo141185/mopidy repository overview

⁠mopidy-docker: A Docker image for mopidy

Mopidy⁠ an extensible music server that plays music from local disk, Spotify, Tidal, Youtube, SoundCloud, TuneIn, and more.

⁠Links

Source: GitHub⁠
Docker-Images: DockerHub⁠

⁠About

Using Docker images built on top of this repo, mopidy with its extensions can be easily run on multiple machines with different architectures (amd64, arm). Besides the music server mopidy, the image includes the great web interface IRIS⁠ from jaedb. Please note that the image only includes a minimal set of the basic mopidy extensions:

• Mopidy-Local
• Mopidy-MPD

Other useful extensions can be installed and keep updated by pip on container startup. Simply add them to the environment variable PIP_PACKAGES as a list of package names.

⁠Prerequisites

You need to have Docker up and running on a Linux machine. See the official documentation to install the Docker Engine⁠

⁠Get the image

Here is the repository⁠ on DockerHub.

Getting the image from DockerHub is as simple as typing:

docker pull jojo141185/mopidy:release

You can pull other, probably less stable image builds by the following tags

⁠Usage

You can start the mopidy container by simply using the command docker run⁠ or the docker compose⁠ tool where you can store your docker configuration in a seperate yaml file.

In both ways you need to adapt the command or docker-compose.yaml file to your specific host environment.

⁠Manage Docker as a non-root user

If you need to run docker as non-root user then you need to add it to the docker group.

1. Create the docker group, if it does not already exist
   sudo groupadd docker
2. Add your user to the docker group
   sudo usermod -aG docker $USER
3. Log in to the new docker group (should avoid having to log out & log in again):
   newgrp docker
4. Check if docker can be run without root
   docker run hello-world
   Try to reboot if you still get permission error!

Warning: The docker group grants privileges equivalent to the root user. For details on how this impacts security in your system, see Docker Daemon Attack Surface⁠

⁠docker run

Start the mopidy docker container with the docker run command:

docker run -d \
    --name mopidy \
    --user root \
    --group-add audio \
    --device /dev/snd \
    -v "$PWD/config:/config" \
    -v "$PWD/media:/media:ro" \
    -v "$PWD/local:/var/lib/mopidy/local" \
    -p 6600:6600 -p 6680:6680 \
    jojo141185/mopidy:release

The following table describes the docker arguments and environment variables:

Note:

• The host user specified by PUID should have access to the local volume mounts and its group specified by PGID must be a member of the system audio group to avoid permission issues with the audio device.
• Depending on the number and size of PIP_PACKAGES you have, it may take a while to start on first run. Please be patient and look at the logs.
• On problems accessing the web interface, check mopidy.conf using the correct IP address. Try "hostname: 0.0.0.0" to listen to any interface and check that "allowed_origins = " has no restrictions (is empty).

⁠docker compose

First check that Docker compose is already installed⁠ on your host.

1. Copy the docker-compose.yml⁠ file from this repository to the current directory.
2. Make sure that your mopidy config file (mopidy.conf) is placed in a subfolder named "config".
   You can also add / modify the volume paths in the yaml file, i.e. to your local media folder or the directory where the metadata information will be stored on host (see table above).
3. Start the mopidy container with the following command
   Compose V1: docker-compose up -d
   Compose V2: docker compose up -d

⁠Build

You can build (or rebuild) the image by opening a terminal from the root of the repository and issuing the following command:

docker build --build-arg IMG_VERSION="release" -t jojo141185/mopidy .

It will take a long time, espacialy on a Raspberry Pi. When it's finished, you can run the container following the previous instructions.
Just be careful to use the tag from your own built.

⁠References

Spotify disabled access to libspotify on May 16 2022. To be able to use Spotify as audio source, the mopidy-Spotify-Plugin was tweaked by @kingosticks. It now uses the GStreamer plugin "gst-plugins-spotify" in the background to play Spotify songs.
For this reason this mopidy container should be seen as an alpha version with limited features in interaction with Spotify (i.e. no seeking support).