Skip to content
Switch branches/tags
This branch is 134 commits ahead of gallery/gallery3:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Gallery 3.1+ (development version)


Gallery 3 is a web based software product that lets you manage your photos on your own website. You must have your own website with PHP and database support in order to install and use it. With Gallery you can easily create and share albums of photos via an intuitive interface.

Intended Audience

This version is intended for anybody who has a website. We stand ready to support the product and help you to make the most of it. We welcome theme and module developers to play with this release and start turning out slick new designs for our happy users. If you have questions or problems, you can get help in the Gallery forums:!forum/gallery-3-users


Did you find a security flaw? Please submit an issue in github:

Supported Configuration

  • Platform: Linux / Unix.
  • Web server: Apache 2.2 and newer.
  • PHP 7.0 and newer (PHP's safe_mode must be disabled and simplexml, filter, and json must be installed).
  • short_open_tag isn't required but additional modules and themes may rely on it.
  • Database: MySQL 5 and newer.

For complete system requirements, please refer to:

Installing and Upgrading Instructions

NOTE: When upgrading from PHP 5 to PHP 7 you will need to change the database type from mysql to mysqli in var/database.php:

$config['default'] = array(
  'benchmark'     => false,
  'persistent'    => false,
  'connection'    => array(
    'type'     => 'mysqli',

For docker installations:

For comprehensive instructions, The online User Guide is your best resource:

There are also simple instructions below. NOTE: You can upgrade from beta 1 and beyond, but not from alpha releases.

Installation via the web

Point your web browser at gallery3/installer/ and follow the instructions.

Installation from the command line

php installer/index.php [-h host] [-u user] [-p pass] [-d dbname]

Command line parameters:

 -h     Database host          (default: localhost)
 -u     Database user          (default: root)
 -p     Database user password (default: )
 -d     Database name          (default: gallery3)
 -x     Table prefix           (default: )

Optional dependencies

Install composer dependencies to make all of the modules work (currently autorotate, phpmailer). In the top level gallery directory where the composer.json file exists run the following:

composer install

Bugs, Questions, Problems?

Forgot your password? Use the command line:

php index.php passwordreset <username>


The simplest, most intuitive way to host your photos on your website.







No packages published