Pigalle Install

  • Requirements
  • Quick Install
  • Upgrading to a newer version


  • Any kind of operating system. Pigalle has been tested on both Linux and Windows.
  • Apache webserver (http://www.apache.org [1]). Pigalle works on both Apache 1.3.xx or 2.0.x. On Windows, it might work on IIS as well, but currently we are not doing any testing on it.
  • One of the following database systems:
    • MySQL 4.0.x/4.1.x database or later version (http://www.mysql.com [2]).
    • PostgreSQL (http://www.postgresql.org [3])
    • SQLite (http://www.sqlite.org [4])
    • Microsoft SQL Server 2000 (http://www.microsoft.com/sql/ [5])
    • The following database systems might be supported in the near future: FrontBase, Borland InterBase, Sybase
  • PHP 5.1 or later version.
  • Image Library:
    • ImageMagick (recommended!)
    • PECL/imagick ImageMagick wrapper
    • GD library
    • NetPBM
  • of course all of it working together ... and a HTML-browser

For your information: the Pigalle demonstration [6] we are using currently is actually served by a PHP 5.6.30 and ZendEngine 2.6.0 backend.

Quick Install

Installation of Pigalle is EASY! There is not even an installation script required to run, because Pigalle automatically detects a new installation. The current installation instructions are located in your Pigalle distribution: /private/doc/INSTALL.

[1] Unzip the distribution and make sure you keep the file-structure

[2] Edit config.inc.php and enter your database information
    At least, change the following settings:
    $conf['dsn'] = array(
        'username' => 'xxxxxxxx',
        'password' => 'xxxxxxxx',
        'database' => 'xxxxxxxx'

[3] Make the following directories writable:
    chmod 777 cache/
    chmod 777 albums/
    chmod 777 archives/
    chmod 777 private/log/
    If your webserver runs under the same group as your user, chmod 660
    might as well do it.

[4] Run Pigalle!
    That's it, you won't need any further install instructions, as
    Pigalle does automatically detect a new installation and creates
    the needed tables in your database. Default configuration is good
    in most cases.
    Run index.php from your browser and enjoy Pigalle!

[5] To create a new album, just copy a whole directory that contains all
    your images into /albums. Next time you call index.php from your 
    browser, the new album will be automatically available.

[6] To configure your new installation, please log-in with the default
    admin user:
    username= admin
    password= 1234
    You should then enter the "User Administration" (link on top of page).
    Either create your own user(s) and delete the default admin user or 
    at least change his password.

Upgrading to a newer version

Upgrading to a newer version of Pigalle is easy. All you need to do is to replace the whole Pigalle directory with the newer release files. You only need to re-enter the connection options of your database connection in the new config.inc.php. There is no further action required. Pigalle will automatically upgrade your database scheme if required on the first web access to your Pigalle installation. It will detect your previous version information and automatically runs an incremental upgrade.

Driven by coWiki 0.3.4 web collaboration tool.