Vejledninger /

Installering

/

Docker-image

Docker-image

Når denne vejledning følges, henter du en compose-fil med alt hvad du behøver for at udrulle din Piwigo med Docker.


Denne vejledning forudsætter at du kan etablere forbindelse til din server vha. ssh og allerede har installeret docker, hvis det ikke er tilfældet, så følg den officielle Docker-dokumentation.

Trin 1 - Installering af containeren

Skab forbindelse til din server og opret en mappe med navnet Piwigo:

  • Hent filen compose.yaml fra Piwigo/piwigo-docker

  • Du kan anvende curl til at hente det, uden at forlade terminalen

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

  • Opret en fil med navnet .env, den skal indeholde følgende, med en stærk adgangskode efter lig med-tegnet uden anførselstegn.

  • piwigo_port=8080
    db_user_password=
    timezone=
    PIWIGO_UID=
    PIWIGO_GID=

    Du kan anvende trancate til at generere en gyldig adgangskode vha. følgende kommando:

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

    Du kan ændre den udstillede port ved at redigere piwigo_port

    Opsæt den brugers og grupps UID og GID, som du ønsker at give adgang til Piwigo-mappen i felterne PIWIGO_UID og PIWIGO_GID

Start din container med docker compose up -d

Trin 2 - Opsæt reverse proxy

Du bør anvende en ekstern reverse proxy med Piwigo Docker, du kan anvende følgende Nginx-opsætningseksempler.

Piwigo understøtter hosting på et domæne, underdomæne og/eller understi; uanset hvad du vælger, fraråder vi at lade Piwigos versionsnummer fremgår af URL'en.

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;
	}
}

Hvis du vil host'e Piwigo på en understi (fx: mit_domæne.tld/gallery), skal du videresende det til containeren ved at tilføje proxy_set_header X-Forwarded-Prefix /min_understi

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;
    }
}

Trin 3 - Opsætning

Når containeren er startet og din reverse proxy er opsat, åbnes en webbrowser på den webadresse, som du host'er Piwigo på. Piwigo vil opdage at der endnu ikke er installeret noget og stille dig videre til installeringssiden

Hvis du ændrede piwigo_port i .env, skal du også ændre afsnittet proxy_pass tilsvarende. Husk på at Docker pr. design ignorerer alle dine firewallregler.

Udfyld forbindelsesoplysningerne til MySQL-databasen med følgende :

  • Vært : piwigo-db:3306
  • Bruger : piwigodb_user
  • Adgangskode : Anvend adgangskoden du skrev i .env-filen
  • Databasenavn : piwigodb
  • Et præfiks til Piwigos tabelnavne : piwigo_

Følgende er krævet for at oprette en webmasterkonto:

  • Et kontonavn, som vælges af dig
  • En adgangskode, som du skal skrive to gange for kontrol
  • Din mailadresse, så besøgende kan kontakte dig

Kør handlingen "Start Install" ("Start installering").

Installeringsside

Du får besked om hvorvidt installeringsprocessen lykkedes eller ej.

Installering gennemført

Trin 4 - Første forbindelse

Når installeringen er færdig, kan du gå ind i dit galleri. Log på med din webmasterkonto, for at få adgang til administrationspanelet.

Piwigo er installeret

Har du stadig ubesvarede spørgsmål?

Du kan få hjælp i vores forum eller finde dine egne svar i dokumentationen