Skip to content

Latest commit

 

History

History
143 lines (93 loc) · 4.64 KB

guide_piwigo.rst

File metadata and controls

143 lines (93 loc) · 4.64 KB
Raw
.. author:: GodMod <godmod@eqdkp-plus.eu>

.. tag:: lang-php
.. tag:: web
.. tag:: gallery
.. tag:: photo

Logo

Piwigo

.. tag_list::

Piwigo is an open source photo gallery. It allows you to create several galleries and share them with yourself, selected individuals or the world.

Note

For this guide you should be familiar with the basic concepts of

License

Piwigo is released under the GNU General Public License version 2 or any later version.

Prerequisites

We're using :manual:`PHP <lang-php>` in the stable version 7.3:

[isabell@stardust ~]$ uberspace tools version use php 7.3
Selected PHP version 7.3
The new configuration is adapted immediately. Patch updates will be applied automatically.
[isabell@stardust ~]$ uberspace tools version show php
Using 'PHP' version: '7.3'
[isabell@stardust ~]$

If you want to use your Piwigo with your own domain you need to setup your domain first:

Installation

cd to your :manual:`document root <web-documentroot>`, download the latest release of Piwigo, extract it and remove the archive afterwards.

Note

Check the Piwigo website or Github Repository for the latest stable release and copy the download link to the piwigo-2.xx.x.zip file. Then use wget to download it. Use the latest release URL or replace the URL with the one you just got from GitHub.

[isabell@stardust ~]$ cd /var/www/virtual/$USER/html/
[isabell@stardust html]$ wget https://piwigo.org/download/dlcounter.php?code=latest -O piwigo.zip
[isabell@stardust html]$ unzip piwigo.zip
[isabell@stardust html]$ mv piwigo/* .
[isabell@stardust html]$ rm piwigo.zip
[isabell@stardust html]$

Configuration

Create Database

Piwigo saves your data in a :manual:`MySQL <database-mysql>` database. It is recommended to use an :manual_anchor:`additional database <database-mysql.html#additional-databases>` (e.g. isabell_piwigo) instead of the default database.

Note

You need to create the database before you enter the database :manual_anchor:`credentials <database-mysql.html#login-credentials>` in the Piwigo Installer.

[isabell@stardust ~]$ mysql -e "CREATE  DATABASE ${USER}_piwigo"
[isabell@stardust ~]$

Piwigo Installer

The final configuration can easily be done in the browser. Point your Browser to your installation URL https://isabell.uber.space/install.php.

Enter the following details:

Basic configuration
  • Default gallery language select your desired default language
Database configuration
Administration configuration
  • Username the name of your admin user, e.g. isabell
  • Password chose a strong password for your user
  • Password confirm enter your password again
  • Email address your email address; will be publicly visible
  • Options
    • uncheck the option Subscribe to Piwigo Announcements Newsletter if you don't want to get Emails from Piwigo
    • uncheck the option Send my connection settings by email, as the email will contain your cleartext password for your user

After that, you are finished with the installation and can now add photos to your gallery.

Updates

Note

Check the update feed regularly to stay informed about the newest version.

The easiest way to update Piwigo is to use the web updater provided in the admin section of the Web Interface: Tools > Updates.

Tested with Piwigo 2.10.2, Uberspace 7.6.1.2

.. author_list::