Mopidy
Mopidy is an extensible, Python-based music server for homelabs and home networks.
Platform availability
Available on 2 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
80/100 Excellent
- Maintained
- 100last commit 18 days ago
- Popular
- 798,609 GitHub stars
- Easy to install
- 452 install platforms, install notes, Docker image
- Light to run
- No data
- Security check
- 75no serious findings
Based on 4 of 5 factors.
Availability: platform listings confirmed today, links checked 43 days ago
- GitHub stars
- 8,609
- Open issues
- 175
- Last commit
- 2026-11-02
- Latest release
- v4.0.5
- License
- Apache-2.0
- Activity
- steady
Checked 11 days ago - source: GitHub (mopidy/mopidy)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is not supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Get Mopidy installed first On Debian/Ubuntu, run sudo apt update, then sudo apt install mopidy. This installs the app and core pieces, so Mopidy can start without missing base files. source
- Install audio playback support If you're doing a manual install, install GStreamer (the audio engine) and its Python bindings. Without it, Mopidy may start but may not be able to play music or some file types. source
- Tell Mopidy where your music is In Mopidy-File settings, set media_dirs to the folders that hold your music. If you don't, Mopidy won't know where to look and your local files won't show up. source
- Unraid container setup Set the container to bridge networking (br0) with a static IP. Mount a config volume to /mopidy.conf (see the Mopidy configuration docs for the file format), mount your local media folder, and if you use Snapcast mount a /tmp volume so the snapfifo sockets are shared. source
Fetched 45 days ago - each note links to its source
Variants
Alternatives (6)
- Ampache - Ampache is a self-hosted, web-based media server that streams and manages your music and video libraries from any device.
- Amperfy Music
- Funkwhale - Open-source, self-hosted streaming platform supports Android, iOS, podcasts, uploads, sharing, no ads or tracking, federated across decentr…
- Subsonic - Subsonic is a free, web-based media streamer, providing ubiquitous access to your music and video.
- ampd - Ampd is a free, self-hosted web client for Music Player Daemon that lets users browse music libraries and control playback from a modern, r…
- koel - Free, open-source, self-hosted music streaming server that turns a personal music collection into a fast, browser-based listening experienc…
Checked 51 days ago - source: AlternativeTo
Common questions
How do I tell Mopidy where my local music files are?
In the Mopidy-File extension settings, set media_dirs to the folders that hold your music. If you don't, Mopidy won't know where to look and your local files won't show up.
Why can Mopidy start but fail to play some music?
Install GStreamer and its Python bindings if you do a manual install. Without that audio engine, Mopidy may start but may not be able to play music or some file types.
How can I install Mopidy on Debian or Ubuntu?
Run sudo apt update, then sudo apt install mopidy. This installs Mopidy and the core pieces needed to start without missing base files.
Can I control Mopidy from a phone or tablet?
Yes. You can control it from any MPD or web client on a phone, tablet, or computer.
Where should I go if Mopidy setup stops working?
Use the built-in debugging tools, or ask for help on the Mopidy Discourse forum or the #mopidy-users Zulip stream.
Answers sourced from docs.mopidy.com, docs.mopidy.com, docs.mopidy.com, docs.mopidy.com, selfhost.directory
Community
- FAQ - Mopidy Discourse (forum)
- Welcome to discourse.mopidy.com - Meta - Mopidy Discourse (forum)
- Mopidy Discourse (forum)
Collected 53 days ago - public community threads