Con esta guía descargará un archivo Compose con todo lo necesario para desplegar su propio Piwigo con Docker.
Esta guía asume que puede conectarse a su servidor mediante SSH y que ya tiene instalado Docker. Si no es así, consulte la documentación oficial de Docker aquí.
Conéctese a su servidor y cree una carpeta llamada Piwigo:
Descargue el archivo compose.yaml desde Piwigo/piwigo-docker.
Puede usar curl para descargarlo sin salir del terminal.
curl -O "https://raw.githubusercontent.com/Piwigo/piwigo-docker/refs/heads/main/compose.yaml"
Cree un archivo llamado .env. Debe contener lo siguiente: una contraseña segura y su zona horaria después del signo igual (sin comillas).
piwigo_port=8080
db_user_password=
timezone=
PIWIGO_UID=
PIWIGO_GID=
Puede usar truncate para generar una contraseña válida con el siguiente mandato:
printf $(tr -dc '[:alnum:]' </dev/urandom | head -c64)"\n"
Puede cambiar el puerto expuesto editando piwigo_port.
Defina el UID y el GID del usuario y grupo a que desea dar acceso a la carpeta de Piwigo en los campos PIWIGO_UID y PIWIGO_GID.
Inicie el contenedor con docker compose up -d
Necesitará usar un proxy inverso externo con Piwigo Docker; puede usar los siguientes ejemplos de configuración de Nginx:
Piwigo da soporte al alojamiento en un dominio, subdominio o subruta; independientemente de la opción que elija, se recomienda no usar el número de versión de Piwigo en la 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;
}
}
Si planea alojar Piwigo en una subruta (p. ej., mi_dominio.tld/galeria), deberá redirigirlo al contenedor añadiendo proxy_set_header X-Forwarded-Prefix /mi_subruta.
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;
}
}
Una vez iniciado el contenedor y configurado el proxy inverso, abra un navegador en la dirección web donde aloja Piwigo. Piwigo detectará que aún no hay nada instalado y le redirigirá a la página de instalación.
Si ha modificado piwigo_port en .env, también deberá modificar la sección proxy_pass para reflejarlo. Tenga en cuenta que Docker ignorará todas las reglas de su cortafuegos por diseño.
Complete la configuración de conexión de la base de datos MySQL con lo siguiente: :
piwigo-db:3306piwigodb_userpiwigodbpiwigo_
Se necesita lo siguiente para crear la cuenta de webmaster:
Ejecute la acción “Iniciar instalación” (Start Install)
Lado de la instalación
Se le informará sobre el éxito o fracaso del proceso de instalación.
Instalación satisfactoria
Una vez haya terminado la instalación, puede visitar su galería. Inicie sesión con la cuenta de webmaster y podrá llegar al panel de administración.
Piwigo está instalado
Puede obtener ayuda en el foro o encontrar sus propias respuestas en la documentación