Guide /

Installazione

/

Immagine Docker

Immagine Docker

Utilizzando questa guida, scaricherai un file di Docker Compose con tutto il necessario per distribuire il tuo Piwigo con Docker.


Questa guida presuppone che tu possa connetterti al tuo server tramite ssh e che tu abbia già installato Docker, in caso contrario segui la documentazione ufficiale di Docker qui

Passo 1 - Installare il contenitore

Connettiti al tuo server e crea un cartella denominata Piwigo:

  • Scarica il file compose.yaml da Piwigo/piwigo-docker

  • Puoi utilizzare il comando curl per scaricarlo senza lasciare il terminale

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

  • Crea un file denominato .env, che contenga il quanto segue, con una password forte dopo il segno di uguale senza virgolette.

  • piwigo_port=8080
    db_user_password=
    timezone=

    È possibile utilizzare truncate per generare una password valida con il seguente comando:

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

    You can change the exposed port by editing piwigo_port

Avvia il tuo contenitore con docker compose up -d

Passo 2 - Configura il proxy inverso

Vorrai utilizzare un proxy inverso esterno con Piwigo Docker; puoi usare i seguenti esempi di configurazione Nginx:

Piwigo supporta l'hosting su un dominio, un sottodominio e/o un sottopercorso; qualunque sia la scelta, si consiglia di non utilizzare il numero di versione di Piwigo nell'URL.

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

Se intendi ospitare Piwigo su di un sottopercorso (ad esempio: my_domain.tld/gallery) dovrai inoltrarlo al contenitore aggiungendo proxy_set_header X-Forwarded-Prefix /my_subpath

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

Phase 3: impostazioni

Una volta avviato il contenitore e configurato il proxy inverso, apri un browser web all'indirizzo web su cui stai ospitando Piwigo. Piwigo rileverà che non è ancora installato nulla e ti reindirizzerà alla pagina di installazione.

Se hai modificato piwigo_port in .env, dovrai modificare anche la sezione proxy_pass per riflettere tale modifica. Tieni presente che Docker ignorerà automaticamente tutte le regole del firewall.

Inserisci i seguenti parametri per la connessione al database MYSQQL :

  • Indirizzo del server : piwigo-db:3306
  • Il tuo ID di accesso : piwigodb_user
  • Password : Utilizza la password che hai scritto nel file .env
  • Il nome della base dati : piwigodb
  • Il prefisso delle tabelle Piwigo : piwigo_

Per creare l'account amministratore della galleria, è necessario completare::

  • ID dell'account da inserire in base alla tua scelta
  • La password associata a questo ID, da inserire una seconda volta per conferma
  • L'indirizzo e-mail che consente ai visitatori di mettersi in contatto con te

Fare clic su "avvia installazione".

Pagina installazione

Se tutto va bene o se c'è un problema, sarai informato

Installazione riuscita

Phase 4: dopo l'installazione

Una volta completata l'installazione, puoi andare alla galleria. Identificati per accedere alla parte amministrativa.

La galleria è installata

Hai ancora delle domande rimaste senza risposta?

Puoi ottenere assistenza sul forum o trovare le risposte nella documentazione