From ArchWiki
Revision as of 15:05, 26 February 2009 by Gishten (talk | contribs) (Added iconv info + minor edit)
Jump to navigation Jump to search


This document describes how to set up Ampache on an Arch Linux LAMP server. Ampache is a Web-based Audio file manager. It is implemented with MySQL, and PHP. It allows you to view, edit, and play your audio files via the web. It has support for playlists, artist and album views, album art, random play, playback via Http/On the Fly Transcoding and Downsampling, Ampache is excellent if you want to be able to listen to your music collection anywhere.


You'll need three things to run Ampache. A webserver, PHP and MySQL. Please refere to the LAMP wiki for more information.

Ampache is available in the AUR, if you haven't had any experience using the AUR the AUR User Guidelines is recommended reading.

Currently maintained packages

There are currently two Ampache packages.


Uncomment the ; line in the php.ini file. To enable the iconv support for ampache

# vi /etc/php/php.ini

When Ampache is installed to you webroot point your browser to http://localhost/ampache.

If you encounter any problems here, use http://localhost/ampache/test.php to double check your configuration.

  • On the first page just chose your the installation language.
  • On the second page enter the following:
    • Desired Database Name - Choose a proper name the you'll recognize when you edit your mysql databases.
    • MySQL Hostname - localhost is fine.
    • MySQL Administrative Username - root is the default
    • MySQL Administrative Password - Don't forget to set a password!

       # mysqladmin -u root password NEWPASSWORD 
    • Create Database User for New Database? - Yes.
    • Ampache Database Username - Samething here, proper and recognizable.
    • Ampache Database User Password - Please note that this is only MySQL info, this is not your Ampache user account
    • Overwrite Existing
    • Use Existing Database
  • On the third page you're going to edit the ampache.cfg.php file
    • Web Path - Your patch to ampache.
    • Desired Database Name - Same as on the second page.
    • MySQL Hostname - localhost.
    • MySQL Username - Same as Ampache Database Username or root if you didn't create a database user.
    • MySQL Password - MySQL Username's password.
  • Press write config
  • Move the ampache.cfg.php to the ampache/config directory.
  • Press check for config.
  • On the fourth page you're going to create an admin account. This is step is self explanatory.
    • Username
    • Password
    • Confirm Password


If you're having problems adding catalogs, please check your permission settings. If you're still having problems check your Open basedir setting in php.ini. More catalog toubleshooting here.

Another useful link to the Ampache wiki