Mopidy Download and Install for Raspberry Pi & Ubuntu

What Mopidy is

Mopidy is an extensible music server written in Python. It is not a desktop player with an installer; it runs as a background service, indexes your local files and exposes a control surface that browsers, phones and MPD clients can talk to.

The current release is v4.0.4 under the Apache-2.0 license, with 8.6k stars on GitHub. It is distributed as a Python package, so there is no .exe or .dmg to grab. That is by design, not an omission, and it is why this page is about installing rather than downloading.

Almost everything beyond local playback comes from extensions: streaming backends, internet radio, web frontends and MPD frontends are all separate packages you install alongside the core.

Best for

• Raspberry Pi and always-on home audio setups where a quiet server beats a laptop
• People who already have a local library and want it indexed, searchable and reachable from every device
• Headless servers and Docker hosts where nothing should be running in a window
• Users comfortable editing a plain text configuration file instead of clicking through a wizard
• Multi-room houses that want several clients attached to one library at the same time

Key features

• Local file playback with library indexing, search and playlists
• Streaming backends, internet radio and web frontends added through extensions
• MPD protocol support, so any MPD client or phone app can drive the server
• Browser-based control through a web frontend extension
• Python 3 core that can be scripted, extended and packaged the way you like
• Runs on Linux, macOS and Windows, and on Raspberry Pi OS
• Free and open source under Apache-2.0 — no account, no telemetry, no paid tier

Platforms & requirements

Officially supported platform: Linux, macOS and Windows, always installed as a Python package rather than an application bundle. Python 3 is the one hard requirement, plus an audio output that GStreamer can talk to.

On Raspberry Pi, Mopidy is distributed through the project's own apt repository for Raspberry Pi OS, which also pulls a matched set of GStreamer plugins and the service unit. That route avoids compiling anything on a slow SD card.

On Ubuntu and Debian, the same apt repository is the recommended source; pip install mopidy is the fallback for a virtual environment or a second installation. Docker images exist for people who prefer containers, and the Raspberry Pi runs the same Python core as every other platform.

How to install Mopidy safely

• Read the official installation documentation first — the pip and apt instructions there are the supported path
• On Raspberry Pi and Ubuntu, add the project's apt repository and install with apt, so system packages stay consistent
• On macOS or Windows, install into a Python virtual environment instead of the system interpreter
• Create a Mopidy configuration file for your music directories and audio output before starting the service
• Run Mopidy as a system service so it restarts on reboot, and watch the journal for the first startup
• Install extensions from the official Mopidy organisation or their own repositories — not from third-party bundles that glue Mopidy and plugins together

Limits to know

• There is no official installer, portable build or app store listing — if a site offers a Mopidy Setupper or all-in-one exe, it is not from the project
• Mopidy never provides music. It plays files you already own and streams you point it at; without a library or an extension it stays quiet
• Configuration is text files and service units, so expect a terminal and an editor on day one
• Extension quality and maintenance vary, and a backend can break when a streaming service changes something upstream
• Streaming extensions usually want your own account credentials, stored in that same configuration file
• The web frontends are separate projects, so the player interface you use is not covered by Mopidy's own release cycle

Alternatives to compare

If you want a polished desktop interface for a self-hosted server rather than a headless backend, Feishin is the natural companion: it talks to Navidrome, Jellyfin and OpenSubsonic servers and gives them a real desktop and web client.

If what you actually want is a local library player on one computer, with no server and no configuration file, Strawberry is the closer match — the same collectors' library idea, wrapped in a normal desktop application.

Mopidy wins when the music must live on a box that is always on and be reachable from anywhere. The other two win when the music lives on the machine you are sitting at.