Piwigo, eine selbst gehostete Fotogalerie¶

Meldet Euch als Root-Benutzer auf dem Server an:

sudo mysql -u root -p

Legt den MySQL-Benutzer piwigoadmin an (passt den Benutzernamen entsprechend an). Ersetzt dabei die Zeichenfolge SicheresPasswort mit einem sicheren, individuellen Passwort:

CREATE USER 'piwigoadmin'@localhost IDENTIFIED BY 'SicheresPasswort';

Erstellt anschließend die von Piwigo benötigte Datenbank und erteilt die richtigen Berechtigungen:

CREATE DATABASE piwigo;
GRANT ALL ON piwigo.* TO 'piwigoadmin'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Meldet Euch erneut bei MySQL als piwigoadmin an (passt den Benutzernamen entsprechend an):

sudo mysql -u piwigoadmin -p

Vergewissert Euch, dass die piwigo-Datenbank korrekt angelegt wurde:

SHOW DATABASES;

Das Ergebnis sollte in etwa folgendermaßen aussehen:

+--------------------+
| Database           |
+--------------------+
| information_schema |
| piwigo             |
+--------------------+
2 rows in set (0.01 sec)

Verlasst MySQL:

EXIT;

Voraussetzungen¶

PHP ist zur Ausführung von Piwigo erforderlich. Ein vorheriges Kapitel zur Serversicherheit hat sich bereits mit der Installation und Absicherung von PHP beschäftigt. Dies sollte bereits einige wichtige Voraussetzungen von Piwigo erfüllen, wie z.B. php8.1-{common,mysql,curl,xmlrpc,gd,mbstring,xml,intl,cli,zip}.

Zudem solltet Ihr die folgenden zusätzlichen PHP-Module installieren:

sudo apt install php8.1-{cgi,soap,ldap,readline,imap,tidy}
sudo apt install libapache2-mod-php8.1

Installation¶

Sucht nach der aktuellsten Version des Piwigo-Pakets zum selbst hosten. Zum Zeitpunkt der Abfassung dieses Textes war das Version 12.2.0. Führt die folgenden Befehle aus, um das Paket herunterzuladen und zu entpacken:

wget http://piwigo.org/download/dlcounter.php?code=latest -O /tmp/piwigo.zip
sudo unzip /tmp/piwigo.zip 'piwigo/*' -d /var/www

Legt die richtigen Berechtigungen fest:

sudo chown -R www-data:www-data /var/www/piwigo/
sudo chmod -R 755 /var/www/piwigo/
sudo ls -al /var/www/

Erstellt eine Apache-Konfigurationsdatei:

sudo vi /etc/apache2/sites-available/myphotos.gofoss.duckdns.org.conf

Fügt den folgenden Inhalt hinzu und passt die Einstellungen an Eure eigene Konfiguration an, z. B. den Domain-Namen (myphotos.gofoss.duckdns.org), den Pfad zu den SSL-Schlüsseln, die IP-Adressen und so weiter:

<VirtualHost *:80>

ServerName              myphotos.gofoss.duckdns.org
ServerAlias             www.myphotos.gofoss.duckdns.org
Redirect permanent /    https://myphotos.gofoss.duckdns.org/

</VirtualHost>

<VirtualHost *:443>

ServerName              myphotos.gofoss.duckdns.org
ServerAlias             www.myphotos.gofoss.duckdns.org
ServerSignature         Off

SecRuleEngine           Off
SSLEngine               On
SSLProxyEngine          On
SSLProxyCheckPeerCN     Off
SSLCertificateFile      /etc/dehydrated/certs/gofoss.duckdns.org/fullchain.pem
SSLCertificateKeyFile   /etc/dehydrated/certs/gofoss.duckdns.org/privkey.pem
DocumentRoot            /var/www/piwigo

<Location />
    Order deny,allow
    Deny from all
    Allow from 127.0.0.1
    Allow from 192.168.1.0/24
    Allow from 10.8.0.1/24
</Location>

<Directory /var/www/piwigo/>
    Options +FollowSymlinks
    AllowOverride All
    Require all granted
</Directory>

ErrorLog ${APACHE_LOG_DIR}/myphotos.gofoss.duckdns.org-error.log
CustomLog ${APACHE_LOG_DIR}/myphotos.gofoss.duckdns.org-access.log combined

</VirtualHost>

Speichert und schließt die Datei (:wq!).

Beachtet, dass die SSL-Verschlüsselung für Piwigo mit der Anweisung SSLEngine On aktiviert und das zuvor erstellte SSL-Zertifikat /etc/dehydrated/certs/gofoss.duckdns.org/fullchain.pem sowie der private SSL-Schlüssel /etc/dehydrated/certs/gofoss.duckdns.org/privkey.pem verwendet wurden.

Beachtet ebenfalls, dass ModSecurity in der Apache-Konfigurationsdatei mit der Anweisung SecRuleEngine Off deaktiviert wurde, da Piwigo und ModSecurity nicht gut miteinander harmonieren.

Maximale Fotogröße¶

Öffnet die auf dem Server gespeicherte Apache-PHP-Konfigurationsdatei

sudo vi /etc/php/8.1/apache2/php.ini

Ändert die folgenden Parameter oder fügt diese hinzu, um die maximale Upload-Dateigröße auf 20 MB zu erhöhen:

upload_max_filesize = 20M
post_max_size = 20M

Öffnet die PHP-Konfigurationsdatei der Kommandozeilen-Schnittstelle (auf Englisch, command line interface oder CLI):

sudo vi /etc/php/8.1/cli/php.ini

Ändert die folgenden Parameter oder fügt diese hinzu, um die maximale Upload-Dateigröße auf 20 MB zu erhöhen:

upload_max_filesize = 20M
post_max_size = 20M

Nachbereitung¶

Ruft https://myphotos.gofoss.duckdns.org auf (passt die URL entsprechend an) und folgt dem Konfigurationsassistenten:

Sobald die Konfiguration abgeschlossen ist, klickt auf die Schaltflächen Start der Installation, Galerie ansehen und Fotos hinzufügen. Das war's, Piwigo ist einsatzbereit!

Ihr könnt noch ein paar grundlegende Einstellungen unter Konfiguration ‣ Optionen ‣ Allgemein vornehmen:

• ändert Titel und Banner der Galerie
• deaktiviert die Benutzerregistrierung (Häkchen bei Neuregistrierung von Benutzern erlauben)
• verfolgt, wer sich bei Piwigo anmeldet (wählt Besuche in der Historie speichern für Gäste, registrierte Besucher und/oder Administratoren)

In diesem Beispiel fügen wir Georg als Administrator hinzu, sowie die Benutzer Lenina, Tom und RandomUser.

Meldet Euch als Administrator an und ruft den Menü-Eintrag Admin ‣ Alben ‣ Verwaltung ‣ Liste auf. Klickt auf Album hinzufügen, um ein neues Album anzulegen. Oder bewegt die Maus über ein bestehendes Album und klickt auf Bearbeiten. Ihr könnt nun die Eigenschaften des Albums, die Sortierreihenfolge oder die Berechtigungen ändern.

In diesem Beispiel fügt der Administrator Georg dem Album Holidays eine Beschreibung hinzu.

Beginnt damit, eine Sicherungskopie Eurer Fotos anzulegen, falls während des Upgrades etwas schief laufen sollte. Die Sicherungskopie kann entweder mit Hilfe einer FTP-Verbindung (FileZilla) zum Server erstellt werden, wie zuvor beschrieben. Sichert hierzu die Verzeichnisse /var/www/galleries und /var/www/upload.

Ansonsten könnt Ihr ebenfalls Piwigos Datenbank mit MySQL dump oder einem Server Backup sichern. Die MySQL-Datenbank von Piwigo wird normalerweise in /var/lib/mysql gespeichert.

Meldet Euch schließlich als Webmaster piwigoadmin@gofoss.net an (passt den Webmaster-Namen entsprechend an) und ruft den Eintrag Admin ‣ Werkzeuge ‣ Aktualisierungen ‣ Piwigo-Aktualisierung auf. Klickt auf `Aktualisierung zu Piwigo xx.x.x`` und bestätigt Eure Wahl.