To install, download the latest relase version to a webserver folder. The Pumilio application requires:

Create a database and user in MySQL, you can use the mysql client or phpmyadmin. Then, rename the file config.php.dist to config.php and add the MySQL server and credentials:
#Database settings
$host = "localhost";
$user = "";
$password = "";
$database = "";

Then, on your browser, go to the application URL, adding install/. For example, if the address is:

Then go to:

This will check the necessary software and folder permissions. Add an administrative user. After this step you can delete the folders install and upgrade.

Installation steps for Ubuntu

To install the necessary software from the command line, follow these steps. First, install the LAMP stack (Apache, PHP5, MySQL):

sudo apt-get install tasksel
sudo tasksel install lamp-server

Install the required packages for audiolab and Pumilio:

sudo apt-get install python-dev python-setuptools python-numpy libsndfile1-dev libasound2-dev imagemagick sox libsox-dev libsox-fmt-all python-imaging flac lame

Then download audiolab version 0.8 and install it:

tar -xvzf scikits.audiolab-0.8.tar.gz 
cd scikits.audiolab-0.8/
sudo python install

Allow uploads of bigger files

The file size limit for uploaded files is determined in the php.ini file, by default 2MB. In Ubuntu its located in /etc/php5/apache2/php.ini. Set the desired value in the variables upload_max_filesize and post_max_size, then restart Apache. Please consult the PHP manual for more info. Look here for some pitfalls to avoid.

To upgrade

Before trying to update, be sure to make a backup of the files and database.

If you are upgrading from version 1.0, or newer, replace the files with the last release, without replacing the following folders:

Check the config.php file. It should only contain the MySQL credentials and optional variables listed in the Administrator Guide. Then go to the application address /upgrade (if the address is, then go to This will upgrade the database structure and make all necessary checks. If you miss this step, the application may not work as intended.