Guías /

Instalación

/

Imagen de Docker

Imagen de Docker

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í.

Paso 1: Instalación del contenedor

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

Paso 2: Configurar el proxy inverso

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

Paso 3 - Configuración

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: :

  • Host : piwigo-db:3306
  • Usuario : piwigodb_user
  • Contraseña : Utilice la contraseña que escribió en el archivo .env.
  • Nombre de la base de datos : piwigodb
  • Un prefijo para las tablas de Piwigo : piwigo_

Se necesita lo siguiente para crear la cuenta de webmaster:

  • Un identificador de cuenta, elegido por usted
  • Una contraseña que tiene que escribir dos veces, como comprobación
  • Su dirección de correo electrónico para que los visitantes puedan ponerse en contacto con usted

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

Paso 4 - Primera conexión

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

¿Aún le quedan preguntas sin responder?

Puede obtener ayuda en el foro o encontrar sus propias respuestas en la documentación