Debian/Ubuntu: Install from apt.mopidy.comΒΆ

If you run a Debian based Linux distribution, like Ubuntu, the easiest way to install Mopidy is from the Mopidy APT archive. When installing from the APT archive, you will automatically get updates to Mopidy in the same way as you get updates to the rest of your system.

If you’re on a Raspberry Pi running Debian or Raspbian, the following instructions should work for you as well. If you’re setting up a Raspberry Pi from scratch, we have a guide for installing Debian/Raspbian and Mopidy. See Raspberry Pi: Mopidy on a credit card.


The packages should work with:

  • Debian stable and testing,
  • Raspbian stable and testing,
  • Ubuntu 14.04 LTS and later.

Some of the packages, including the core “mopidy” packages, does not work on Ubuntu 12.04 LTS.

This is just what we currently support, not a promise to continue to support the same in the future. We will drop support for older distributions when supporting those stops us from moving forward with the project.

  1. Add the archive’s GPG key:

    wget -q -O - | sudo apt-key add -
  2. Add the following to /etc/apt/sources.list, or if you have the directory /etc/apt/sources.list.d/, add it to a file called mopidy.list in that directory:

    # Mopidy APT archive
    deb stable main contrib non-free
    deb-src stable main contrib non-free

    For the lazy, you can simply run the following command to create /etc/apt/sources.list.d/mopidy.list:

    sudo wget -q -O /etc/apt/sources.list.d/mopidy.list
  3. Install Mopidy and all dependencies:

    sudo apt-get update
    sudo apt-get install mopidy
  4. Optional: If you want to use any Mopidy extensions, like Spotify support or scrobbling, you need to install additional packages.

    To list all the extensions available from, you can run:

    apt-cache search mopidy

    To install one of the listed packages, e.g. mopidy-spotify, simply run:

    sudo apt-get install mopidy-spotify

    For a full list of available Mopidy extensions, including those not installable from, see Extensions.

  5. Before continuing, make sure you’ve read the Debian package section to learn about the differences between running Mopidy as a system service and manually as your own system user.

  6. Finally, you need to set a couple of config values, and then you’re ready to run Mopidy.

When a new release of Mopidy is out, and you can’t wait for you system to figure it out for itself, run the following to upgrade right away:

sudo apt-get update
sudo apt-get dist-upgrade