piwigo:piwigo-auf-unraid:start

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Nächste Überarbeitung		 Vorhergehende Überarbeitung
piwigo:piwigo-auf-unraid:start [2026/08/29 12:33] – angelegt jfpiwigo:piwigo-auf-unraid:start [2026/08/30 19:31] (aktuell) – jf
Zeile 1: Zeile 1:
-# Piwigo auf Unraid+====== Piwigo ======
  
-Schritt für Schritt zu einer eigenen Foto- und Video-Galerie: MariaDB und Piwigo als Container, Video-Wiedergabe aktiviert, Upload-Limits hochgesetzt und Alben, die sich zum Präsentieren eignen.+Piwigo https://de.piwigo.com/ ist eine Open-Source-Software zur Verwaltung und Präsentation von Foto- und Bildergalerien im Web. Man installiert sie auf einem eigenen Webserver (selbst gehostet) und kann darüber Fotos hochladen, in Alben organisieren, mit Tags versehen und Besuchern oder ausgewählten Nutzern zugänglich machen.
  
-`Docker` · `LinuxServer.io Image` · `MariaDB` · `Unraid 6.12+` · `Fotos + Videos`+===== Zu den wichtigsten Merkmalen gehören: =====
  
-## Inhalt+Piwigo läuft auf PHP/MySQL und lässt sich per Plugin- und Theme-System erweitern. Es unterstützt mehrere Benutzerkonten mit unterschiedlichen Zugriffsrechten, sodass sich zum Beispiel private Alben nur für bestimmte Personen freigeben lassen. Es gibt Funktionen wie automatische Miniaturbilder, Kommentare, Bewertungen, Metadaten-Auslesen (EXIF/IATPC), Batch-Uploads und Apps bzw. Tools für den Upload von Desktop und Smartphone aus.
  
-- [00 · Überblick](#00-ueberblick) +Es wird oft als selbst gehostete Alternative zu Diensten wie Google Photos oder Flickr genutzt, etwa von Fotografen, Vereinen oder Familien, die ihre Bilder unter eigener Kontrolle behalten wollen. Es gibt sowohl eine kostenlose Version zum Selbsthosten als auch einen bezahlten Hosting-Service (Piwigo.com).
-- [01 · Voraussetzungen](#01-voraussetzungen) +
-- [02 · Datenbank (MariaDB)](#02-datenbank-mariadb) +
-- [03 · Piwigo-Container](#03-piwigo-container) +
-- [04 · Ersteinrichtung](#04-ersteinrichtung) +
-- [05 · Video-Wiedergabe aktivieren](#05-video-wiedergabe-aktivieren) +
-- [06 · Upload-Limits erhöhen](#06-upload-limits-erhoehen) +
-- [07 · Alben & Präsentation](#07-alben-praesentation) +
-- [08 · Von unterwegs erreichen](#08-von-unterwegs-erreichen) +
-- [09 · Fehlerbehebung](#09-fehlerbehebung) +
-- [10 · Backup](#10-backup)+
  
-## 00 · Überblick+===== Piwigo für ===== 
 + 
 +++++ Antiquare | 
 +Piwigo ist tatsächlich eine gute und günstige Lösung für Antiquare, die ihre Bestände digital verwalten und Kunden ansprechend präsentieren wollen, egal ob es um alte Postkarten, Buchcover, Grafiken oder sonstige historische Dokumente geht. 
 + 
 +Der größte Vorteil liegt in der Bildverwaltung selbst: Piwigo ist im Kern ein Digital Asset Management System, das auch mit großen Mengen an Scans zurechtkommt. Man legt Alben und Unteralben an und bekommt so eine Struktur, in der sich tausende Aufnahmen, Buchrücken, Signaturen, Detailfotos vernünftig sortieren lassen, ohne den Überblick zu verlieren. 
 + 
 +Gerade bei antiquarischen Beständen zählt ja der Kontext oft mehr als das Bild allein. Hier hilft, dass Piwigo Tags, Beschreibungstexte und automatisch ausgelesene EXIF/IPTC Daten unterstützt. So kann man zu jedem Stück Zustand, Erscheinungsjahr, Autor oder Herkunft hinterlegen, und Kunden finden über die Suche genau das, wonach sie suchen. 
 + 
 +Auch bei der Rechteverwaltung ist man flexibel: Alben lassen sich ganz normal öffentlich als Katalog freigeben, oder man macht sie privat und gibt sie nur ausgewählten Sammlern nach Login frei, praktisch etwa für Erstausgaben oder Neuzugänge, die noch nicht für jeden sichtbar sein sollen. 
 + 
 +Wer Piwigo selbst hostet, behält zudem die volle Kontrolle über die eigenen Bild und Kundendaten und macht sich nicht von den Konditionen irgendeiner Drittplattform abhängig. 
 + 
 +Und falls man hochauflösende Scans seltener Stiche, Landkarten oder Grafiken vor unbefugtem Kopieren schützen möchte, bringt Piwigo eine automatische Wasserzeichen Funktion gleich mit. 
 +++++ 
 + 
 +++++ Handwerker | 
 +Piwigo ist eine hervorragende Open-Source-Bilddatenbank, mit der Handwerksbetriebe ihre Baustellendokumentation, Projektbilder und Kunden-Referenzen effizient und datenschutzkonform organisieren können 
 + 
 +Da Handwerker täglich unzählige Fotos von Baufortschritten, Mängeln und fertigen Gewerken machen, dient Piwigo als zentrales, digitales Archiv. 
 + 
 +=== Vorteile für Handwerker === 
 +  * **Strukturierte Baustellendokumentation:** Alben lassen sich flexibel nach Kundenname, Projektnummer oder Jahr sortieren. Mithilfe von Schlagworten (Tags) filterst du blitzschnell nach „Rohbau“, „Sanitär“, „Mangel“ oder „Vorher-Nachher“. 
 +  * **Rechtssicherheit & Nachweis:** Fotos sicherst du gegen unberechtigte Mängelansprüche ab. Über den Datumsfilter findest du exakt das Foto vom Zustand an Tag X. 
 +  * **Referenzmappen für Kunden:** Du kannst ausgewählte Alben für potenzielle Kunden freigeben, um eure Arbeit digital zu präsentieren (z. B. auf einem Tablet direkt beim Beratungsgespräch). 
 +  * **Volle Datenkontrolle & DSGVO:** Im Gegensatz zu US-Cloud-Diensten kannst du Piwigo auf deinem eigenen Webserver oder Firmen-NAS installieren (Self-Hosting). Deine Kundendaten und Baustellenfotos bleiben komplett in deiner Hand. 
 +  * **Mobiles Hochladen per App:** Mitarbeiter können Fotos direkt von der Baustelle per Smartphone-App in die Datenbank hochladen. 
 +  * **Rechteverwaltung:** Du entscheidest, welche Mitarbeiter Zugriff auf welche Projektordner haben. 
 + 
 +^ Einsatzbereich ^ Funktion / Nutzen ^ Praxisbeispiel ^ 
 + 
 +| **Baudokumentation** | Visuelle Festhaltung von Baufortschritten und Mängeln zur rechtlichen Absicherung. | Hochladen von Fotos direkt von der Baustelle per Smartphone-App. | 
 +| **Referenzmappe & Marketing** | Präsentation von fertigen Projekten für potenzielle Neukunden. | Einbindung einer öffentlichen Galerie auf der eigenen Handwerker-Webseite. | 
 +| **Kunden-Updates** | Transparente Kommunikation des aktuellen Arbeitsstandes mit dem Auftraggeber. | Freigabe eines passwortgeschützten Albums exklusiv für den jeweiligen Kunden. | 
 +| **Zentrales Bildarchiv** | Strukturierte und durchsuchbare Lagerung aller Firmenfotos über Jahre hinweg. | Schnelles Wiederfinden von Vorher-Nachher-Bildern durch Schlagworte (Tags). | 
 +| **Interne Schulung** | Visuelles Material zur Einarbeitung von Azubis und neuen Mitarbeitern. | Alben mit Best-Practice-Beispielen für fachgerechte Ausführungen (z. B. Abdichtungen). | 
 + 
 +++++ 
 + 
 + 
 + 
 +====== Piwigo auf Unraid ====== 
 + 
 +Schritt für Schritt zu einer eigenen Foto- und Video-Galerie: MariaDB und Piwigo als Container, Video-Wiedergabe aktiviert, Upload-Limits hochgesetzt und Alben, die sich zum Präsentieren eignen. 
 + 
 +''Docker'' · ''LinuxServer.io Image'' · ''MariaDB'' · ''Unraid 7.3.2'' · ''Fotos + Videos'' 
 + 
 +===== 00 · Überblick ===== 
 + 
 +Piwigo ist eine quelloffene Software für eine eigene, selbst gehostete Foto- und Video-Galerie. Damit organisierst du Bilder und Videos in Alben, versiehst sie mit Tags und Beschreibungen und gibst sie gezielt frei: öffentlich, nur für eingeloggte Nutzer oder passwortgeschützt für einzelne Alben. Typische Einsatzzwecke sind private Familien- und Urlaubsalben, Vereins- oder Veranstaltungsfotos sowie Portfolios für Kunden, ohne dabei auf Google Fotos, Dropbox & Co. angewiesen zu sein.
  
 Piwigo braucht zwei Bausteine: einen **Piwigo-Container** (Webserver + PHP, Bild von LinuxServer.io) und eine **MariaDB-Datenbank**, in der Alben, Nutzer und Metadaten liegen. Die eigentlichen Fotos und Videos landen auf einem eigenen Unraid-Share, nicht in der Datenbank. Piwigo braucht zwei Bausteine: einen **Piwigo-Container** (Webserver + PHP, Bild von LinuxServer.io) und eine **MariaDB-Datenbank**, in der Alben, Nutzer und Metadaten liegen. Die eigentlichen Fotos und Videos landen auf einem eigenen Unraid-Share, nicht in der Datenbank.
  
-```+<code>
 [ Browser / Mobile-App ] [ Browser / Mobile-App ]
           |           |
Zeile 33: Zeile 72:
           |           |
           +---> [ Share /gallery ]     Original-Fotos & -Videos           +---> [ Share /gallery ]     Original-Fotos & -Videos
-```+</code>
  
-Das Ergebnis: eine Galerie mit Alben, feiner Rechteverwaltung (z. B. passwortgeschützte Familienalben) und – nach ein paar Zusatzschritten – sauber abspielbaren Videos.+Das Ergebnis: eine Galerie mit Alben, feiner Rechteverwaltung (z. B. passwortgeschützte Familienalben) und, nach ein paar Zusatzschritten, sauber abspielbaren Videos.
  
-## 01 · Voraussetzungen+===== 01 · Voraussetzungen =====
  
-- Unraid mit installiertem **Community Applications**-Plugin. +  * Unraid mit installiertem **Community Applications**-Plugin. 
-- Zwei Shares bzw. Ordner planen: einen für die App-Konfiguration (z. B. `appdata/piwigo`) und einen eigenen für die Mediendateien (z. B. `gallery`) – getrennt von `appdata`, damit große Videos nicht im appdata-Backup landen. +  * Zwei Shares bzw. Ordner planen: einen für die App-Konfiguration (z. B. ''appdata/piwigo'') und einen eigenen für die Mediendateien (z. B. ''gallery''), getrennt von ''appdata'', damit große Videos nicht im appdata-Backup landen. 
-- PUID/PGID: Unraid nutzt standardmäßig den Benutzer `nobody` (UID `99`) und die Gruppe `users` (GID `100`) – nicht die `1000/1000`, die in der allgemeinen LinuxServer-Doku auftauchen. Für Unraid `PUID=99` und `PGID=100` verwenden.+  * PUID/PGID: Unraid nutzt standardmäßig den Benutzer ''nobody'' (UID ''99'') und die Gruppe ''users'' (GID ''100''), nicht die ''1000/1000'', die in der allgemeinen LinuxServer-Doku auftauchen. Für Unraid ''PUID=99'' und ''PGID=100'' verwenden.
  
-> **Tipp:** Vergib der Unraid-Weboberfläche und den Containern eine feste IP oder nutze durchgehend Container-*Namen* statt IP-Adressen. Das erspart dir Nacharbeit, falls sich die DHCP-Adresse später ändert (siehe [Fehlerbehebung](#09-fehlerbehebung)).+> **Tipp:** Vergib der Unraid-Weboberfläche und den Containern eine feste IP oder nutze durchgehend Container-//Namen// statt IP-Adressen. Das erspart dir Nacharbeit, falls sich die DHCP-Adresse später ändert (siehe Abschnitt 09 · Fehlerbehebung).
  
-## 02 · Datenbank (MariaDB)+===== 02 · Datenbank (MariaDB) =====
  
-Läuft auf deinem Unraid bereits ein Datenbank-Container und Port `3306` ist schon belegt, gibt es zwei sinnvolle Wege – beide sind hier beschrieben.+Läuft auf deinem Unraid bereits ein Datenbank-Container und Port ''3306'' ist schon belegt, gibt es zwei sinnvolle Wege. Beide sind hier beschrieben.
  
-### Option A · vorhandenen Container mitbenutzen (empfohlen)+==== Option A · vorhandenen Container mitbenutzen (empfohlen) ====
  
 Piwigo braucht keinen eigenen Datenbankserver, nur eine eigene Datenbank und einen eigenen Benutzer darin. Das spart RAM und einen weiteren Container. Direkt in der laufenden Datenbank anlegen: Piwigo braucht keinen eigenen Datenbankserver, nur eine eigene Datenbank und einen eigenen Benutzer darin. Das spart RAM und einen weiteren Container. Direkt in der laufenden Datenbank anlegen:
  
-```bash+<code bash>
 docker exec -it <name-deines-db-containers> mysql -u root -p docker exec -it <name-deines-db-containers> mysql -u root -p
-```+</code> 
 + 
 +> **Alternative:** Genauso gut geht das über das **Konsolen-Icon** („>_") des DB-Containers im Unraid-WebUI (Docker-Tab). Das öffnet direkt eine Shell //innerhalb// des Containers. Dort reicht dann einfach ''mysql -u root -p'', ohne das vorangestellte ''docker exec -it …''. Kein SSH auf den Unraid-Host nötig.
  
 Danach in der MySQL-Shell (Container- und Nutzernamen anpassen): Danach in der MySQL-Shell (Container- und Nutzernamen anpassen):
  
-```sql+<file sql mysql-shell>
 CREATE DATABASE piwigo CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE DATABASE piwigo CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
 CREATE USER 'piwigo'@'%' IDENTIFIED BY 'DEIN_PASSWORT'; CREATE USER 'piwigo'@'%' IDENTIFIED BY 'DEIN_PASSWORT';
Zeile 65: Zeile 106:
 FLUSH PRIVILEGES; FLUSH PRIVILEGES;
 EXIT; EXIT;
-```+</file> 
 + 
 +> **Per Adminer statt Kommandozeile?** Wirfst du diesen Block in Adminers SQL-Befehl-Funktion statt in die ''mysql''-Shell: Bei ''CREATE USER''/''GRANT''/''FLUSH'' ist „0 Datensätze betroffen" normal, kein Fehler. Die letzte Zeile ''EXIT;'' dagegen lass weg: Das ist ein Kommando nur für die ''mysql''-Kommandozeile, kein echtes SQL, und erzeugt in Adminer einen harmlosen Syntaxfehler. 
 + 
 +==== Alternative per Weboberfläche: Adminer ==== 
 + 
 +Wer die drei SQL-Zeilen lieber klickt statt tippt: Läuft noch kein Verwaltungstool für die Datenbank, lohnt sich die Installation von **Adminer**, einem einzigen PHP-Skript ohne eigene Konfiguration, das in Sekunden startklar ist. 
 + 
 +<file yaml docker-compose.yml> 
 +services: 
 +  adminer: 
 +    image: adminer:latest 
 +    container_name: adminer 
 +    restart: unless-stopped 
 +    environment: 
 +      - ADMINER_DEFAULT_SERVER=<name-oder-ip-deines-db-containers> 
 +    ports: 
 +      - 8087:8080 
 +</file> 
 + 
 +Alternativ genauso einfach über Community Applications: nach ''Adminer'' suchen und installieren. Danach im Browser öffnen, als System ''MySQL/MariaDB'' wählen, Server/Host sowie Benutzername ''root'' und Root-Passwort eingeben. 
 + 
 +> **Wichtig beim Login:** Das Feld „Datenbank" im Login-Formular **leer lassen**: ''piwigo'' existiert ja noch nicht, ein Login direkt damit schlägt fehl. Ohne dieses Feld landest du auf Server-Ebene mit der Liste aller Datenbanken. 
 + 
 +  * **Datenbank anlegen:** Auf Server-Ebene unten auf //„Create database"// klicken, Namen ''piwigo'' und Kollation ''utf8mb4_unicode_ci'' eintragen. 
 +  * **Benutzer anlegen:** Auf Server-Ebene (oder in der neuen Datenbank) den Menüpunkt //„Privileges"// öffnen, dort //„Create user"// wählen und Benutzername, Passwort sowie die Rechte auf ''piwigo'' vergeben. 
 + 
 +Das entspricht genau den drei SQL-Zeilen von oben, nur per Klick statt getippt. 
 + 
 +> **Adminer oder phpMyAdmin?** Für diese eine Aufgabe, eine Datenbank plus einen Benutzer anlegen, ist Adminer klar die bessere Wahl: eine einzelne, kleine PHP-Datei statt einer vollständigen Anwendung mit vielen Dateien, dadurch schneller geladen und mit kleinerer Angriffsfläche. phpMyAdmin hat mehr Funktionstiefe für komplexere Datenbankarbeit (feingranulare Rechteverwaltung, mehr Import/Export-Optionen), für einen schnellen CREATE-DATABASE-Vorgang im Homelab ist das aber nicht nötig.
  
-Läuft daneben bereits Adminer oder phpMyAdmin für diesen Container, geht das Anlegen genauso bequem über die Weboberfläche. Als Datenbank-Host trägst du im Piwigo-Assistenten die IP des Unraid-Servers (oder den Container-Namen, in einem gemeinsamen Docker-Netzwerk) mit dem **gewohnten Port** ein, z. B. `3306` – der ändert sich nicht, du legst nur eine zusätzliche Datenbank in der bestehenden Instanz an.+Als Datenbank-Host trägst du im Piwigo-Assistenten die IP des Unraid-Servers (oder den Container-Namen, in einem gemeinsamen Docker-Netzwerk) mit dem **gewohnten Port** ein, z. B. ''3306''. Der ändert sich nicht, du legst nur eine zusätzliche Datenbank in der bestehenden Instanz an.
  
-> **Geteilter Container:** Ein Image-Update des DB-Containers betrifft die Daten nicht – Datenbank, Benutzer und Rechte liegen im gemappten Volume, nicht im Image. Was sich ändert: Piwigo teilt sich jetzt Wartungsfenster und kurze Neustart-Ausfälle mit der anderen App. Vor größeren Versionssprüngen lohnt sich ein Dump **aller** Datenbanken (`mysqldump --all-databases`), nicht nur von `piwigo`.+> **Geteilter Container:** Ein Image-Update des DB-Containers betrifft die Daten nicht: Datenbank, Benutzer und Rechte liegen im gemappten Volume, nicht im Image. Was sich ändert: Piwigo teilt sich jetzt Wartungsfenster und kurze Neustart-Ausfälle mit der anderen App. Vor größeren Versionssprüngen lohnt sich ein Dump **aller** Datenbanken (''mysqldump --all-databases''), nicht nur von ''piwigo''.
  
-### Option B · eigener, zweiter Datenbank-Container+==== Option B · eigener, zweiter Datenbank-Container ====
  
-Spricht etwas dagegen, den vorhandenen Server mitzubenutzen (andere App, andere Backup-Routine, härtere Trennung gewünscht), bekommt Piwigo seine eigene MariaDB – nur eben nicht auf Host-Port 3306, der ist ja schon vergeben. Der Container selbst lauscht *innerhalb* weiterhin ganz normal auf 3306, nur die Weiterleitung nach außen bekommt eine andere Nummer, z. B. `3307`:+Spricht etwas dagegen, den vorhandenen Server mitzubenutzen (andere App, andere Backup-Routine, härtere Trennung gewünscht), bekommt Piwigo seine eigene MariaDB, nur eben nicht auf Host-Port 3306, der ist ja schon vergeben. Der Container selbst lauscht //innerhalb// weiterhin ganz normal auf 3306, nur die Weiterleitung nach außen bekommt eine andere Nummer, z. B. ''3307'':
  
-```yaml+<file yaml docker-compose.yml>
 services: services:
   piwigo-db:   piwigo-db:
Zeile 93: Zeile 163:
       - 3307:3306       - 3307:3306
     restart: unless-stopped     restart: unless-stopped
-```+</file>
  
-Im Piwigo-Setup-Assistenten dann als Datenbank-Host `<Unraid-IP>:3307` eintragen – Host und Port zusammen, getrennt durch Doppelpunkt. Hängst du `piwigo` und `piwigo-db` stattdessen in ein gemeinsames, benutzerdefiniertes Docker-Netzwerk, reicht als Host der Container-Name `piwigo-db` mit dem **internen** Port `3306` – die externe Portverschiebung betrifft dann nur den Zugriff von außerhalb des Netzwerks.+Im Piwigo-Setup-Assistenten dann als Datenbank-Host ''<Unraid-IP>:3307'' eintragen: Host und Port zusammen, getrennt durch Doppelpunkt. Hängst du ''piwigo'' und ''piwigo-db'' stattdessen in ein gemeinsames, benutzerdefiniertes Docker-Netzwerk, reicht als Host der Container-Name ''piwigo-db'' mit dem **internen** Port ''3306''. Die externe Portverschiebung betrifft dann nur den Zugriff von außerhalb des Netzwerks.
  
-> **Hinweis zur Adresse:** Egal für welche Option: Wer beide Container in ein gemeinsames Docker-Netzwerk hängt, kann durchgehend mit **Container-Namen** statt IP-Adressen arbeiten – das übersteht spätere IP-Änderungen des Unraid-Servers.+> **Hinweis zur Adresse:** Egal für welche Option: Wer beide Container in ein gemeinsames Docker-Netzwerk hängt, kann durchgehend mit **Container-Namen** statt IP-Adressen arbeiten. Das übersteht spätere IP-Änderungen des Unraid-Servers.
  
-## 03 · Piwigo-Container+===== 03 · Piwigo-Container =====
  
-In Community Applications nach `Piwigo` suchen. Ist kein Template gelistet, lässt sich der Container auch manuell über „Docker → Add Container" mit dem Repository `lscr.io/linuxserver/piwigo` anlegen.+In Community Applications nach ''Piwigo'' suchen. Ist kein Template gelistet, lässt sich der Container auch manuell über „Docker → Add Container" mit dem Repository ''lscr.io/linuxserver/piwigo'' anlegen.
  
-```yaml+<file yaml docker-compose.yml>
 services: services:
   piwigo:   piwigo:
Zeile 118: Zeile 188:
       - 8181:80       - 8181:80
     restart: unless-stopped     restart: unless-stopped
-```+</file>
  
-Wichtig sind die beiden Volumes: `/config` für die Piwigo-Installation selbst, `/gallery` für die eigentlichen Fotos und Videos. Den Host-Port `8181` kannst du frei wählen, falls `80` auf deinem Unraid schon belegt ist.+Wichtig sind die beiden Volumes: ''/config'' für die Piwigo-Installation selbst, ''/gallery'' für die eigentlichen Fotos und Videos. Den Host-Port ''8181'' kannst du frei wählen, falls ''80'' auf deinem Unraid schon belegt ist.
  
-## 04 · Ersteinrichtung+===== 04 · Ersteinrichtung =====
  
-Container starten und im Browser `http://<Unraid-IP>:8181` öffnen. Der Setup-Assistent fragt nach:+Container starten und im Browser <nowiki>http://<Unraid-IP>:8181</nowiki> öffnen. Der Setup-Assistent fragt nach:
  
-- **Datenbank-Host:** IP des Unraid-Servers (oder Container-Name, siehe oben) +  * **Datenbank-Host:** IP des Unraid-Servers (oder Container-Name, siehe oben) 
-- **Datenbank-Name / Benutzer / Passwort:** die Werte aus Schritt 02 +  * **Datenbank-Name / Benutzer / Passwort:** die Werte aus Schritt 02 
-- **Admin-Konto:** Benutzername, Passwort, E-Mail-Adresse für dich selbst +  * **Admin-Konto:** Benutzername, Passwort, E-Mail-Adresse für dich selbst 
-- **Galerie-Name:** Titel, der oben in der Galerie erscheint+  * **Galerie-Name:** Titel, der oben in der Galerie erscheint
  
-Nach dem Assistenten landest du direkt im Admin-Bereich – von hier aus geht es an Videos und Uploads.+Nach dem Assistenten landest du direkt im Admin-Bereich. Von hier aus geht es an Videos und Uploads.
  
-## 05 · Video-Wiedergabe aktivieren+===== 05 · Video-Wiedergabe aktivieren =====
  
 Piwigo nimmt Videos zwar entgegen, spielt sie aber ohne Zusatz-Plugin nicht im Browser ab. Piwigo nimmt Videos zwar entgegen, spielt sie aber ohne Zusatz-Plugin nicht im Browser ab.
  
-**VideoJS-Plugin installieren:** Administration → Module → Erweiterungen: nach `VideoJS` suchen, installieren und aktivieren. Erst danach werden Videos inline abgespielt statt nur als Datei-Download angeboten.+**Video-Plugin installieren:** Administration → Module → Erweiterungen: nach ''VideoJS'' suchen und installieren. Taucht das Plugin unter diesem Namen nicht mehr auf, nach ''piwigo-videojs'' suchen, so heißt die Erweiterung inzwischen. Erst nach der Aktivierung werden Videos inline abgespielt statt nur als Datei-Download angeboten.
  
 **Erlaubte Dateiformate:** Unter Administration → Konfiguration → Optionen die erlaubten Datei-Endungen um die gängigen Web-Formate erweitern: **Erlaubte Dateiformate:** Unter Administration → Konfiguration → Optionen die erlaubten Datei-Endungen um die gängigen Web-Formate erweitern:
  
-| | | +^ Empfohlen | ''mp4'', ''m4v'', ''webm'', ''ogv'' | 
-|---|---| +^ Vermeiden | ''mov'': iPhone-Videos vorher nach MP4 (H.264 + AAC) konvertieren, sonst spielen viele Browser sie nicht ab |
-| Empfohlen | `mp4`, `m4v`, `webm`, `ogv` | +
-| Vermeiden | `mov` – iPhone-Videos vorher nach MP4 (H.264 + AAC) konvertieren, sonst spielen viele Browser sie nicht ab |+
  
-> **Achtung:** Für automatisch erzeugte Video-Vorschaubilder braucht Piwigo zusätzlich `ffmpeg` im Container (im LinuxServer-Image i. d. R. enthalten) sowie eines von `ffprobe`, `exiftool` oder `MediaInfo` für Metadaten. Fehlen Vorschaubilder, zuerst hier ansetzen.+> **Achtung:** Für automatisch erzeugte Video-Vorschaubilder braucht Piwigo zusätzlich ''ffmpeg'' im Container (im LinuxServer-Image i. d. R. enthalten) sowie eines von ''ffprobe'', ''exiftool'' oder ''MediaInfo'' für Metadaten. Fehlen Vorschaubilder, zuerst hier ansetzen.
  
-## 06 · Upload-Limits erhöhen+===== 06 · Upload-Limits erhöhen =====
  
-PHP begrenzt Uploads standardmäßig auf wenige MB – für Fotos meist ausreichend, für Videos schnell zu wenig.+PHP begrenzt Uploads standardmäßig auf wenige MB: für Fotos meist ausreichend, für Videos schnell zu wenig.
  
 Zuerst prüfen, welche Konfigurationsdatei im Container existiert: Zuerst prüfen, welche Konfigurationsdatei im Container existiert:
  
-```bash+<code bash>
 docker exec -it piwigo find / -maxdepth 4 -iname "php-local.ini" -o -iname "php.ini" 2>/dev/null docker exec -it piwigo find / -maxdepth 4 -iname "php-local.ini" -o -iname "php.ini" 2>/dev/null
-```+</code>
  
-Bei LinuxServer-PHP-Images liegt eine überschreibbare `php-local.ini` meist unterhalb von `/config`. Dort (oder in der gefundenen Datei) ergänzen:+Bei LinuxServer-PHP-Images liegt eine überschreibbare ''php-local.ini'' meist unterhalb von ''/config''. Dort (oder in der gefundenen Datei) ergänzen:
  
-```ini+<file ini php-local.ini>
 upload_max_filesize = 2048M upload_max_filesize = 2048M
 post_max_size = 2048M post_max_size = 2048M
 memory_limit = 512M memory_limit = 512M
 max_execution_time = 600 max_execution_time = 600
-```+</file>
  
-Anschließend den Container neu starten. Läuft davor ein **Reverse Proxy** (SWAG, Nginx Proxy Manager), muss dessen Body-Size-Limit (z. B. `client_max_body_size`) ebenfalls angehoben werden – sonst bricht der Upload schon dort ab, bevor er Piwigo überhaupt erreicht.+Anschließend den Container neu starten. Läuft davor ein **Reverse Proxy** (SWAG, Nginx Proxy Manager), muss dessen Body-Size-Limit (z. B. ''client_max_body_size'') ebenfalls angehoben werden, sonst bricht der Upload schon dort ab, bevor er Piwigo überhaupt erreicht.
  
 > **Praxiswert:** 2 GB pro Datei ist für die meisten Handy-Videos großzügig bemessen. Wer regelmäßig größere Rohdateien hochlädt, setzt die Werte entsprechend höher. > **Praxiswert:** 2 GB pro Datei ist für die meisten Handy-Videos großzügig bemessen. Wer regelmäßig größere Rohdateien hochlädt, setzt die Werte entsprechend höher.
  
-## 07 · Alben & Präsentation+===== 07 · Alben & Präsentation =====
  
-- **Struktur zuerst:** Alben und Unteralben anlegen, bevor der große Upload beginnt – Piwigo sortiert nachträglich verschobene Fotos nicht automatisch neu ein. +  * **Struktur zuerst:** Alben und Unteralben anlegen, bevor der große Upload beginnt, denn Piwigo sortiert nachträglich verschobene Fotos nicht automatisch neu ein. 
-- **Upload:** per Weboberfläche (Mehrfachauswahl) oder über die offizielle Mobile-App direkt vom Smartphone in ein bestehendes Album. +  * **Upload:** per Weboberfläche (Mehrfachauswahl) oder über die offizielle Mobile-App direkt vom Smartphone in ein bestehendes Album. 
-- **Diashow:** Piwigo bringt eine eingebaute Diashow-Ansicht pro Album mit; für größere Präsentationen lohnt ein Blick in die Theme-Galerie (Administration → Module → Designs) für eine ruhigere, bildlastigere Darstellung. +  * **Diashow:** Piwigo bringt eine eingebaute Diashow-Ansicht pro Album mit; für größere Präsentationen lohnt ein Blick in die Theme-Galerie (Administration → Module → Designs) für eine ruhigere, bildlastigere Darstellung. 
-- **Freigabe ohne Benutzerkonto:** Alben lassen sich mit einem Album-Passwort versehen und der Link direkt teilen – praktisch für Familie oder Kunden, ohne dass jemand ein eigenes Konto braucht.+  * **Freigabe ohne Benutzerkonto:** Alben lassen sich mit einem Album-Passwort versehen und der Link direkt teilen, praktisch für Familie oder Kunden, ohne dass jemand ein eigenes Konto braucht.
  
-## 08 · Von unterwegs erreichen (optional)+===== 08 · Von unterwegs erreichen (optional) =====
  
 Für Zugriff außerhalb des Heimnetzes nicht den Port direkt am Router freigeben, sondern einen **Reverse Proxy mit HTTPS** davorschalten (z. B. SWAG oder Nginx Proxy Manager, jeweils ebenfalls als Unraid-Container). Piwigo bekommt dann eine eigene Subdomain, der Proxy übernimmt Zertifikat und Verschlüsselung. Für Zugriff außerhalb des Heimnetzes nicht den Port direkt am Router freigeben, sondern einen **Reverse Proxy mit HTTPS** davorschalten (z. B. SWAG oder Nginx Proxy Manager, jeweils ebenfalls als Unraid-Container). Piwigo bekommt dann eine eigene Subdomain, der Proxy übernimmt Zertifikat und Verschlüsselung.
  
-> **Sicherheit:** Starkes Admin-Passwort, regelmäßige Updates des Piwigo-Containers und – falls von außen erreichbar – Zwei-Faktor-Login-Plugin in Betracht ziehen.+> **Sicherheit:** Starkes Admin-Passwort, regelmäßige Updates des Piwigo-Containers und, falls von außen erreichbar, ein Zwei-Faktor-Login-Plugin in Betracht ziehen.
  
-## 09 · Fehlerbehebung+===== 09 · Fehlerbehebung =====
  
-| Symptom | Ursache & Lösung | +^ Symptom ^ Ursache & Lösung ^ 
-|---|---| +| Access denied for user "piwigo"@"…" | Benutzerrechte in MariaDB prüfen, oder Datenbank-Host im Piwigo-Setup korrigieren (''config/database.inc.php''). Container-IP statt Name kann sich nach Neustart ändern. |
-| `Access denied for user 'piwigo'@'…'` | Benutzerrechte in MariaDB prüfen, oder Datenbank-Host im Piwigo-Setup korrigieren (`config/database.inc.php`). Container-IP statt Name kann sich nach Neustart ändern. |+
 | Piwigo erreicht die Datenbank nach Unraid-Neustart nicht mehr | Meist eine geänderte Container-IP. Feste IP vergeben oder auf ein benutzerdefiniertes Docker-Netzwerk mit Container-Namen umstellen. | | Piwigo erreicht die Datenbank nach Unraid-Neustart nicht mehr | Meist eine geänderte Container-IP. Feste IP vergeben oder auf ein benutzerdefiniertes Docker-Netzwerk mit Container-Namen umstellen. |
-| Video wird als Download angeboten statt abgespielt | VideoJS-Plugin fehlt oder ist deaktiviert (Schritt 05). | +| Video wird als Download angeboten statt abgespielt | Video-Plugin (VideoJS bzw. piwigo-videojs) fehlt oder ist deaktiviert (Schritt 05). | 
-| Video wird gar nicht erst akzeptiert | Dateiendung nicht freigegeben, oder es ist eine `.mov`-Datei – vorher nach MP4 konvertieren. | +| Video wird gar nicht erst akzeptiert | Dateiendung nicht freigegeben, oder es handelt sich um eine ''.mov''-Datei. Vorher nach MP4 konvertieren. | 
-| Upload großer Dateien bricht ab | `upload_max_filesize`/`post_max_size` in der php-local.ini zu niedrig (Schritt 06) – oder Limit im vorgeschalteten Reverse Proxy. | +| Upload großer Dateien bricht ab | ''upload_max_filesize''/''post_max_size'' in der php-local.ini zu niedrig (Schritt 06), oder Limit im vorgeschalteten Reverse Proxy. | 
-| Rechte-/Schreibfehler beim Hochladen | PUID/PGID des Containers passen nicht zu den Berechtigungen des `gallery`-Shares. Auf Unraid `99/100` verwenden. | +| Rechte-/Schreibfehler beim Hochladen | PUID/PGID des Containers passen nicht zu den Berechtigungen des ''gallery''-Shares. Auf Unraid ''99/100'' verwenden. | 
-| Host-Port `3306` bereits belegt | Vorhandenen DB-Container mitbenutzen (Option A) oder neuen Container auf einen freien Host-Port wie `3307` legen (Option B) – siehe Schritt 02. |+| Host-Port ''3306'' bereits belegt | Vorhandenen DB-Container mitbenutzen (Option A) oder neuen Container auf einen freien Host-Port wie ''3307'' legen (Option B). Siehe Abschnitt 02. |
  
-## 10 · Backup+===== 10 · Backup =====
  
 Drei Dinge gehören gesichert, damit im Notfall alles wiederherstellbar ist: Drei Dinge gehören gesichert, damit im Notfall alles wiederherstellbar ist:
  
-- `/mnt/user/appdata/piwigo` – Konfiguration und Zugangsdaten +  * ''/mnt/user/appdata/piwigo'': Konfiguration und Zugangsdaten 
-- `/mnt/user/gallery` – die Original-Fotos und -Videos selbst +  * ''/mnt/user/gallery'': die Original-Fotos und -Videos selbst 
-- ein regelmäßiger **MariaDB-Dump** der `piwigo`-Datenbank (Alben, Nutzer, Metadaten stecken hier, nicht in den Dateien)+  * ein regelmäßiger **MariaDB-Dump** der ''piwigo''-Datenbank (Alben, Nutzer, Metadaten stecken hier, nicht in den Dateien)
  
-```bash+<code bash>
 docker exec mariadb mysqldump -u piwigo -p piwigo > piwigo-backup-$(date +%F).sql docker exec mariadb mysqldump -u piwigo -p piwigo > piwigo-backup-$(date +%F).sql
-```+</code>
  
 Das CA-Plugin „Appdata Backup / Restore" deckt den ersten Punkt automatisiert ab; Datenbank-Dump und Gallery-Share sollten zusätzlich in die eigene Backup-Routine (z. B. auf ein zweites Ziel) aufgenommen werden. Das CA-Plugin „Appdata Backup / Restore" deckt den ersten Punkt automatisiert ab; Datenbank-Dump und Gallery-Share sollten zusätzlich in die eigene Backup-Routine (z. B. auf ein zweites Ziel) aufgenommen werden.
  
----+----
  
-*Getestet mit dem LinuxServer.io-Image `lscr.io/linuxserver/piwigo` und MariaDB auf Unraid 6.12+. Piwigo- und Docker-Versionsstände ändern sich – Menüpfade können in neueren Versionen leicht abweichen.*+//Produktiv eingerichtet und getestet mit dem LinuxServer.io-Image ''lscr.io/linuxserver/piwigo'' und MariaDB auf Unraid 7.3.2. Piwigo- und Docker-Versionsstände ändern sich, Menüpfade können in neueren Versionen leicht abweichen.//
  
Impressum | Datenschutz
  • piwigo/piwigo-auf-unraid/start.1787999639.txt.gz
  • Zuletzt geändert: vor 3 Wochen
  • von jf