Aquí encontrarás las versiones disponibles de Pirolab, tanto del cliente como del servidor, así como las instrucciones necesarias para iniciar la aplicación.

Para que Pirolab funcione, es necesario tener un servidor PIROLAB instalado en nuestra máquina o en una máquina dentro de nuestra red local. El sistema operativo de la máquina servidor es indiferente, ya que la aplicación se distribuye mediante una imagen Docker.

La parte cliente está configurada para funcionar en Windows, aunque en futuras versiones se liberará la versión para Linux.

Para poder utilizar la aplicación es necesario tener instalados tanto el servidor como el cliente.

Instalar el cliente

Para instalar el cliente únicamente deberemos descomprimir el archivo ZIP y hacer doble clic sobre el instalable. Una vez iniciado el proceso de instalación, solo tendremos que seguir las instrucciones que aparezcan en pantalla.

Podremos crear un acceso directo en el escritorio o en el menú de inicio de Windows. Una vez finalizada la instalación, podremos acceder a la aplicación con un doble clic.


Si no tenemos acceso al servidor, aparecerá un aviso indicándolo.

Instalar el backend

Se trata de una imagen Docker, por lo que para instalar el servidor de Pirolab es necesario tener Docker instalado. Para la instalación de Docker se puede consultar la página oficial:
https://www.docker.com/

Una vez tengamos Docker instalado en la máquina donde queramos instalar el backend de Pirolab, descargaremos el paquete correspondiente backend-pirolab-x-x-x.

Este paquete contiene todo lo necesario para ejecutar localmente un entorno completo con:

Todo está contenerizado con Docker y puede instalarse en cualquier sistema que tenga Docker instalado.

Configuración inicial

El primer paso es editar el archivo .env con tus credenciales:

DB_ROOT_PASSWORD=tu_password_root
DB_NAME=PIROLAB
DB_USER=pirolab
DB_PASSWORD=tu_password_usuario

🔐 Este archivo no debe compartirse nunca. Contiene datos sensibles.

Arranque

Desde la carpeta del proyecto (pirolab/), ejecuta:

docker compose up --build -d

La primera ejecución puede tardar entre 2 y 5 minutos (construcción de imágenes y descarga de MariaDB).

✅ Los documentos y la base de datos se conservan entre reinicios gracias a los volúmenes de Docker.

Detener el entorno

docker compose down

⚠️ Esto detiene los contenedores, pero conserva todos los datos (documentos, base de datos, etc.).

Para eliminarlo todo (incluidos los datos):

docker compose down -v

Actualizar la aplicación

Si actualizas el código de Spring Boot u OpenProdoc:

  1. Sustituye el archivo springboot/tu-app.jar o los archivos de OpenProdoc.
  2. Reconstruye el entorno:
docker compose up --build -d

Estructura del proyecto

pirolab/
├── docker-compose.yml # Definición de servicios
├── .env.example # Plantilla de configuración
├── .env # ← Crear este archivo (no se distribuye)
├── springboot/ # Backend Spring Boot
│ ├── Dockerfile
│ └── tu-app.jar
└── openprodoc/ # Gestor documental
├── Dockerfile
└── (archivos de la aplicación)

Solución de problemas comunes

🔸 «Access denied for user ‘xxx’@’…'»
Asegúrate de que las credenciales del archivo .env coincidan con las del backend.
Si es la primera instalación, no ejecutes docker compose down -v después de instalar OpenProdoc.

🔸 OpenProdoc no carga
Espera unos 30 segundos la primera vez (puede tardar en arrancar).
Comprueba los logs:

docker logs openprodoc

🔸 Spring Boot no se conecta a MariaDB
Verifica que las variables DB_* del archivo .env sean correctas.
Asegúrate de que el backend utiliza el nombre del servicio mariadb y no localhost.

Soporte

Para dudas o incidencias, contacta con el administrador del sistema:
📧 sol.licituds@pirolab.cat🌱 Este entorno está diseñado para desarrollo y pruebas. Para producción, revisa la configuración de seguridad.

🌱 Este entorno está diseñado para desarrollo y pruebas. Para producción, revisa la configuración de seguridad.

Descargar la última versión del cliente: http://pirolab.cat/index.php/download/frontend-pirolab-0-0-2/

Descargar la última versión del backend: http://pirolab.cat/index.php/download/backend-pirolab-0-0-2/