Type something to search...



3.5k 586
01 May, 2024

What is Ampache ?

Ampache is a web based audio/video streaming application and file manager allowing you to access your music & videos from anywhere, using almost any internet enabled device.

Ampache’s usefulness is heavily dependent on being able to extract correct metadata from embedded tags in your files and/or the file name. Ampache is not a media organiser; it is meant to be a tool which presents an already organised collection in a useful way. It assumes that you know best how to manage your files and are capable of choosing a suitable method for doing so.

The recommended and most stable version is the current stable release6 branch.

You get the latest version with recent changes and fixes but maybe in an unstable state from our develop branch. Scrutinizer Code Quality Code Coverage Codacy Badge Code Climate

If you want to run the last stable version release4 is still available


Please see the wiki and don’t forget to check out the basic config guide after that.


  • A web server. All of the following have been used, though Ampache receives the most testing with Apache:

    • Apache
    • lighttpd
    • nginx
    • IIS
  • The correct PHP version for your Ampache release

    • PHP 7.1-7.4 (Ampache 4.x.x)
    • PHP 7.4 (Ampache 5.0.x and higher)
    • PHP 8.0 (Ampache 5.1.x and higher)
    • PHP 8.1 (Ampache 5.5.0 and higher)
    • PHP 8.2 (Ampache 6.0.0 and higher)
    • PHP 8.3 (Ampache 6.2.0 and higher)

NOTE That php7.4 will not be supported for Ampache6 but can still be built.

  • PHP modules:

    • PDO
    • hash
    • session
    • json (included in php8+)
    • intl
    • simplexml
    • curl
  • For FreeBSD The following php modules must be loaded:

    • php-xml
    • php-dom
    • php-intl
  • MySQL 5.x / MySQL 8.x / MariaDB 10.x


If you are upgrading from an older version of Ampache we recommend moving the old directory out of the way, extracting the new copy in its place and then copying the old /config/ampache.cfg.php, /rest/.htaccess, and /play/.htaccess files if any. All database updates will be handled by Ampache.