Music Player Daemon Wiki


From Music Player Daemon Community Wiki[]

Installing from source should work for all *nix distributions. In many cases it is better to go below to look for specific installation instructions for your distribution if you're in a *nix distribution.


General Installing From Source[]

  • First check that you have all the dependencies that you want from Dependencies
  • Retrieving the sources
    • First, do you want to install from the latest sources in subversion? If so, follow the guide.
    • Otherwise you can download the latest sources
  • Follow the procedure at going straight to the ./configure step if you downloaded from subversion. A hint that that link doesn't give is there are specific options that you can look through by typing ./configure --help, then adding those to your ./configure will make your MPD turn out differently, although the defaults will do just fine.

Debian Install Procedure[]

If you are using Debian Sarge or Sid, then simply do:

apt-get update
apt-get install mpd

Ubuntu Install Procedure[]

  • First, edit /etc/apt/sources.list and enable the 'universe' repository. After you make this change, you will have to run apt-get update.
  • You can use Synaptic. If for some reason this installation fails, this howto on the Ubuntu Forums may help.
apt-get update
apt-get install mpd
  • With this debian package, you don't get the sample config file. You can get it from the regular mpd tarball from the mpd distribution siteAre you sure about that? Here's Ubuntu 6.06:
$ dpkg -L mpd | grep example

(You may wish to zcat the gz file to your favorite target.)

Gentoo Install Procedure[]

If you want to install a subversion ebuild, replace mpd when emerging with mpd-svn

  • Check that you have all the USE flags you want supported for MPD, a hint is checking out the Dependencies page.
# emerge -pv mpd
[ebuild  N    ] media-sound/mpd-0.11.5-r2 
USE="aac alsa audiofile flac mad unicode -ipv6 -mikmod -vorbis" 1,101 kB
  • Install MPD:
# emerge mpd
  • Edit the /etc/mpd.conf file as a superuser:
# {your text editor here} /etc/mpd.conf
    • The log files you specified in /etc/mpd.conf must exist before running MPD.
      • The log files must also have the permissions set so that they can be edited by the default user
    • Put your music/playlists in the directories defined in /etc/mpd.conf (symlinks are fine).
    • Setup MPD to start in the init scripts:
# rc-update add mpd default
  • Create the MPD database:
# /usr/bin/mpd --create-db
  • Finally start MPD:
# /etc/init.d/mpd start

Arch Linux Install Procedure[]

  • Sync and install with pacman
pacman -Sy mpd
  • Configure MPD.
cp /etc/mpd.conf.example /etc/mpd.conf
{your editor} /etc/mpd.conf
  • Create these two directories if they don't exist: ~/.mpd and ~/.mpd/playlists
mkdir ~/.mpd ~/.mpd/playlists
  • Create the MPD database (this can take a while depending on the size of your collection):
/etc/rc.d/mpd create-db
  • Start MPD
/etc/rc.d/mpd start
  • Install a client - this will give you every client in pacman
pacman -Sy ncmpc mpc gmpc glurp

Fedora Install Procedure[]

# yum install mpd


# apt-get install mpd

if you prefer apt.

  • Edit the /etc/mpd.conf file as a superuser:
# {your text editor here} /etc/mpd.conf
  • Create the MPD database:
# mpd --create-db
  • Finally start MPD:
# service mpd start
  • Make it come on when you reboot:
# chkconfig mpd on
  • The clients are available from Fedora Extras. Install them with:
# yum install mpc gmpc

ncmpc is pending...

Mandrake Install Procedure[]

  • MPD is available through urpmi, to install:
urpmi mpd

FreeBSD Install Procedure[]

Installing with Ports[]

    • you may need to update your ports tree (use CVSup, see the FreeBSD handbook)
    • make sure internet works, or put the source file in /usr/ports/distfiles
    • if portupgrade is installed
portinstall musicpd


cd /usr/ports/audio/musicpd
make install clean
      • note: if you want support for AAC or MOD files, then put WITH_AAC=true and WITH_MOD=true in /etc/make.conf before you compile

Installing with Packages[]

  • you may need to set some options, otherwise you will probably get an outdated MPD release (see the FreeBSD handbook)
  • make sure internet works, then do a
pkg install musicpd
pkg add /path/to/package.txz

Configure MPD[]

  • for general configuration: edit /usr/local/etc/mpd.conf (see Configuration for details)
  • to start MPD at boot time: edit /etc/rc.conf and include musicpd_enable=YES
  • initial database creation:
/usr/local/bin/mpd --create-db /usr/local/etc/mpd.conf

Mac OS X 10.3, 10.4 Install Procedure[]

NetBSD Install Procedure[]

  • First select all the dependencies that you want from Dependencies and put the appropriate indications in the PKG_OPTIONS.musicpd variable. Possibilities are: aac, audiofile, flac, iconv, id3, and ogg.
  • install MPD through pkgsrc
    • you may need to update your pkgsrc tree (2004Q2 and up have it) (see the documentation for more information on updating)
cd /usr/pkgsrc/audio/musicpd
make install

  • configure MPD:
    • for general configuration edit /usr/pkg/etc/mpd.conf (see Configuration for details) (example is in /usr/pkg/share/examples/mpd/mpd.conf)
    • initial database creation:
/usr/pkg/bin/mpd --create-db /usr/pkg/etc/mpd.conf

OpenBSD Install Procedure[]

These are the configure script flags I found helpful for getting mpd running on Openbsd 3.8 i386.

MPD 0.11:

  • ./configure --with-ao-includes=/usr/local/include --with-ao=/usr/local/lib --disable-ipv6

MPD 0.12:

  • ./configure --enable-ao --with-ao-includes=/usr/local/include --with-ao=/usr/local/lib

Windows Install Procedure[]

This may not work yet, but if it does the instructions are at Windows Compatibility

OpenWRT Install procedure[]

Full details on how to setup mpd and phpMp2 on OpenWRT are available here

Software Appliance Availability[]

If you have a spare machine (virtual or real) and you don't want to deal with configuration and setup yourself, there is a software appliance based on MusicPD available at -- it's currently shipped as a VMware virtual machine image, and comes with a minimal version of rPath Linux, MusicPD installed and configured, phpMp, and the beginnings of a web-based configuration tool. It also supports music shares over NFS and Samba. Word of warning: the appliance does not include MP3 support.