Skip to main content

Mopidy

Mopidy is available in the NetActuate Marketplace as a one-click, open-source appliance you can deploy into any NetActuate PoP. Extensible music server for local files and internet radio, run from a web UI. It is grouped under the Media & Streaming category.

What It Does​

Mopidy is an open-source, extensible music server written in Python. It plays music from local files and internet radio streams and is controlled entirely over the network, so there is nothing to install on your listening devices. This appliance ships Mopidy with the Mopidy-Iris web client, a polished browser UI for browsing your library, building queues, and controlling playback from a phone, tablet, or desktop.

Key features

  • Web control through the Mopidy-Iris interface on port 6680
  • Plays local audio files and internet radio and playlist streams
  • Also controllable over the classic Music Player Daemon (MPD) protocol
  • HTTP and WebSocket JSON-RPC API for automation and custom clients
  • Extensible through the Mopidy extension ecosystem for more sources
  • Lightweight and self-hosted: one small server, clients on any platform

Use cases

  • A private, self-hosted music player you reach from any browser
  • Whole-home or venue audio when paired with a Snapcast multi-room server
  • A programmable audio backend driven through its HTTP and MPD APIs

Why run it on the NetActuate edge Hosting Mopidy in a PoP keeps the control interface and stream fetching close to a fast, stable network, so the web UI stays responsive and radio streams start quickly wherever you listen.

Upstream attribution: Mopidy is developed and maintained by Stein Magnus Jodal and contributors (https://github.com/mopidy/mopidy) and the Mopidy-Iris web client by James Barnsley (https://github.com/jaedb/Iris); both are free software licensed under the Apache License 2.0. This appliance packages the unmodified upstream Mopidy 3.4.2 (Ubuntu 24.04 LTS package) with Mopidy-Iris 3.70.0 and is not affiliated with or endorsed by the upstream projects.

Vendor and Project​

Mopidy is an open-source project, offered here under the Open Source listing with best-effort community support.

NetActuate supports the underlying infrastructure. Application-level support follows the listing SLA class (open-source, best effort).

Sizing​

vCPURAMDisk
Minimum1512 MB5 GB
Recommended11 GB10 GB

No VPU (hardware acceleration) is required for this appliance. Choose a size at deploy based on your expected load.

Configuration Fields​

When you deploy, you provide these fields. They are written into the appliance at first boot.

FieldRequiredDefaultNotes
Server NameNoMopidyDisplay name for this Mopidy instance, shown by the Iris web client. Defaults to Mopidy.

Using the Appliance​

Mopidy is up

  1. Open the web client. Browse to http://YOUR_VM_IP:6680/iris/ for the Mopidy-Iris control interface.
  2. Add music. Drop audio files into /var/lib/mopidy/media on the server, or browse internet radio and stream URLs directly from Iris.
  3. Control from anywhere. Iris works from any browser on your network; you can also point an MPD client at YOUR_VM_IP port 6600.
  4. Extend it. Install additional Mopidy extensions on the server to add more audio sources, then restart the mkt-mopidy service.

FAQ​

Is there a software license fee? No. Mopidy is open source and free to run. You pay only for the NetActuate infrastructure and bandwidth.

Where is the web interface? On port 6680 at path /iris by default.

Who supports it? NetActuate operates the underlying infrastructure. The application itself is community-supported open source (best-effort SLA class).

Version and Changelog​

VersionStatusReleased
3.4.2Current (default)2026-07-11

Deploy​

Need Help?​

Contact support@netactuate.com or open a support ticket from the portal.