Gidsen /

Installatie

/

Docker Image

Docker Image

Met behulp van deze handleiding downloadt u een compose-bestand met alles wat u nodig hebt om uw eigen Piwigo met Docker te implementeren.


In deze handleiding wordt ervan uitgegaan dat u via SSH verbinding kunt maken met uw server en dat u Docker al hebt geïnstalleerd. Als dat niet het geval is, volgt u de officiële Docker-documentatie hier.

Stap 1 - De container installeren

Maak verbinding met uw server en maak een map met de naam Piwigo:

  • Download het bestand compose.yaml van Piwigo/piwigo-docker

  • U kunt curl gebruiken om het te downloaden zonder de terminal te verlaten

    curl -O "https://raw.githubusercontent.com/Piwigo/piwigo-docker/refs/heads/main/compose.yaml"

  • Maak een bestand met de naam .env. Hierin moet het volgende staan, met een sterk wachtwoord na het gelijkteken, zonder aanhalingstekens.

  • piwigo_port=8080
    db_user_password=
    timezone=

    U kunt truncate gebruiken om een ​​geldig wachtwoord te genereren met de volgende opdracht:

    printf $(tr -dc '[:alnum:]' </dev/urandom | head -c64)"\n"

    Je kunt de open poort wijzigen door piwigo_port te bewerken.

Start uw container met docker compose up -d

Stap 2 - De omgekeerde proxy configureren

Wilt u een externe reverse proxy gebruiken met Piwigo Docker; dan kunt u de volgende Nginx-configuratievoorbeelden gebruiken:

Piwigo ondersteunt hosting op een domein, subdomein en/of subpad. Wat u ook kiest, het is raadzaam om het Piwigo-releasenummer niet in de URL te gebruiken.

server {
	listen 80;
	server_name my_domain.tld;
	location / {
		proxy_pass http://127.0.0.1:8080/;
		proxy_set_header Host $host;
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
		proxy_set_header X-Forwarded-Proto $scheme;
	}
}

Als u van plan bent om Piwigo op een subpad te hosten (bijvoorbeeld: my_domain.tld/gallery), moet u deze doorsturen naar de container door proxy_set_header X-Forwarded-Prefix /my_subpath toe te voegen.

server {
	listen 80;
	server_name my_domain.tld;
	location /gallery/ {
		proxy_pass http://127.0.0.1:8080/;
		proxy_set_header Host $host;
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
		proxy_set_header X-Forwarded-Proto $scheme;
		proxy_set_header X-Forwarded-Prefix /gallery;
    }
}

Stap 3 - Configuratie

Zodra de container is gestart en je reverse proxy is geconfigureerd, open je een webbrowser op het webadres waarop je Piwigo host. Piwigo detecteert dat er nog niets is geïnstalleerd en stuurt je door naar de installatiepagina.

Als u piwigo_port in .env hebt gewijzigd, moet u ook de sectie proxy_pass aanpassen. Houd er rekening mee dat Docker standaard al uw firewallregels negeert.

Vul de MySQL-database verbindings-instellingen in met het volgende :

  • Host : piwigo-db:3306
  • Gebruiker : piwigodb_user
  • Wachtwoord : Gebruik het wachtwoord dat u in het .env-bestand hebt geschreven
  • Database naam : piwigodb
  • Een voorvoegsel voor Piwigo tabelnamen : piwigo_

Het volgende is vereist om het webbeheerder account te maken:

  • Een door jou gekozen account-ID
  • Een wachtwoord moet je twee keer invoeren ter controle
  • Jouw emailadres, zodat bezoekers contact met je kunnen opnemen

Run de "Start installatie"actie

installatie zijde

Je wordt geïnformeerd over het slagen of mislukken van het installatieproces

Succesvolle installatie

Stap 4 Eerste verbinding

Zodra de installatie is voltooid, kun je naar jouw galerij gaan. Log in met jouw webmaster-account en je kunt het administratievenster bereiken

Piwigo is geïnstalleerd

Nog sommige onbeantwoorde vragen?

Je kunt hulp krijgen op forum of vind je eigen antwoorden in de documentatie