1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
|
.. _debian-install:
*************
Debian/Ubuntu
*************
If you run a Debian based Linux distribution, like Ubuntu or Raspbian, the
easiest way to install Mopidy is from the
`Mopidy APT archive <https://apt.mopidy.com/>`_.
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 will 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
:ref:`raspberrypi-installation`.
Distribution and architecture support
=====================================
The packages in the apt.mopidy.com archive are built for:
- **Debian 11 (Bullseye)**,
which also works for Raspbian Bullseye and Ubuntu 22.04 and newer.
The few packages that are compiled are available for multiple CPU
architectures:
- **amd64**
- **i386**
- **armhf**, compatible with all Raspberry Pi models.
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 and
architectures when supporting those stops us from moving forward with the
project.
Install from apt.mopidy.com
===========================
#. Add the archive's GPG key::
sudo mkdir -p /etc/apt/keyrings
sudo wget -q -O /etc/apt/keyrings/mopidy-archive-keyring.gpg \
https://apt.mopidy.com/mopidy.gpg
#. Add the APT repo to your package sources::
sudo wget -q -O /etc/apt/sources.list.d/mopidy.list https://apt.mopidy.com/bullseye.list
#. Install Mopidy and all dependencies::
sudo apt update
sudo apt install mopidy
#. Now, you're ready to :ref:`run Mopidy <running>`.
Upgrading
=========
When a new release of Mopidy is out, and you can't wait for your system to
figure it out for itself, run the following to upgrade right away::
sudo apt update
sudo apt upgrade
Installing extensions
=====================
If you want to use any Mopidy extensions, like Spotify support or Last.fm
scrobbling, you need to install additional packages.
To list all the extensions available from apt.mopidy.com, you can run::
apt search mopidy
To install one of the listed packages, e.g. ``mopidy-mpd``, simply run::
sudo apt install mopidy-mpd
If you cannot find the extension you want in the APT search result, you can
install it from PyPI using ``pip`` instead. You need to make sure you have
``pip``, the Python package installer installed::
sudo apt install python3-pip
Even if Mopidy itself is installed from APT it will correctly detect and use
extensions from PyPI installed globally on your system using::
sudo python3 -m pip install ...
For a comprehensive index of available Mopidy extensions,
including those not installable from APT,
see the `Mopidy extension registry <https://mopidy.com/ext/>`_.
|
