Aquí trobareu les versions disponibles de Pirolab, tant de la part client com del servidor, així com les instruccions necessàries per poder iniciar l’aplicació. Perquè Pirolab funcioni és necessari tenir un servidor PIROLAB instal·lat a la nostra màquina o bé en una màquina dins de la nostra xarxa local. El sistema operatiu de la màquina servidor és indiferent, ja que l’aplicatiu es distribueix mitjançant una imatge Docker. La part client està configurada per a funcionar amb windows, encara que en futures versions alliberarem la versió per a Linux.
Per a poder utilitzar l’aplicació cal tenir instal·lat tant el servidor com el client.
Instal·lar el Client
Per a instal·lar el client únicament haurem de descomprimir el zip i clickar dos cops a l’instal·lable. Un cop comenci el procés d’instal·lació, únicament haurem d’anar seguint les instruccions que surtin per pantalla.
Podrem crear un accés directe a l’escriptori o al menú d’inici de windows. Un cop finalitzada la instal·lació podrem accedir-hi amb un doble click.
Si no tenim accés al servidor, veurem un avis indicant del fent.
Instal·lar el backend
Es tracta d’una imatge Docker, per aquest motiu, per a instal·lar el servidor de Pirolab és necessari tenir instal·lat Docker. Per a la instal·lació de Docker es pot consultar la pàgina oficial: https://www.docker.com/
Un cop tinguem instal·lat Docker en la màquina on volguem instal·lar el backend de Pirolab, ens descarregarem el packet backend-pirolab-x-x-x corresponent.
Aquest paquet conté tot el necessari per executar localment un entorn complet amb:
- Spring Boot (backend a http://localhost:8090)
- OpenProdoc (gestor documental a http://localhost:8080)
- MariaDB (base de dades)
Com tot està contenitzat amb Docker i es pot instal·lar en qualsevol sistema amb Docker instal·lat.
El primer que hem de fer és Edita el fitxer .env amb les teves credencials:
DB_ROOT_PASSWORD=el_teu_password_root
DB_NAME=PIROLAB
DB_USER=pirolab
DB_PASSWORD=el_teu_password_usuari
🔐 Aquest fitxer no es comparteix mai. Conté dades sensibles.
Arrencada
Des de la carpeta del projecte (pirolab/), executa:
docker compose up –build -d
⏱️ La primera execució pot trigar 2-5 minuts (construcció de imatges + descàrrega de MariaDB).
🌐 Accés als serveis
Servei
URL
Notes
OpenProdoc http://localhost:8080
Spring Boot http://localhost:8090
MariaDB localhost:3306
✅ Els documents i la base de dades es conserven entre reinicis gràcies als volums de Docker.
🛑 Aturar l’entorn
docker compose down
⚠️ Això atura els contenidors, però conserva totes les dades (documents, BD, etc.).
Per esborrar-ho tot (incloent dades):
docker compose down -v
🔄 Actualitzar l’aplicació
Si actualitzes el codi de Spring Boot o OpenProdoc:
Reemplaça el fitxer springboot/teva-app.jar o els fitxers d’OpenProdoc.
Reconstrueix:
docker compose up –build -d
📁 Estructura del projecte
pirolab/
├── docker-compose.yml # Definició dels serveis
├── .env.example # Plantilla de configuració
├── .env # ← Crea’t aquest fitxer (no es distribueix!)
├── springboot/ # Backend Spring Boot
│ ├── Dockerfile
│ └── teva-app.jar
└── openprodoc/ # Gestor documental
├── Dockerfile
└── (fitxers de l’aplicació)
❓ Solució de problemes comuns
🔸 “Access denied for user ‘xxx’@’…'”
Assegura’t que les credencials de .env coincideixen amb les del backend.
Si és la primera instal·lació, no facis docker compose down -v després d’instal·lar OpenProdoc.
🔸 OpenProdoc no carrega
Espera 30 segons la primera vegada (pot trigar a arrencar).
Comprova els logs: docker logs openprodoc.
🔸 Spring Boot no es connecta a MariaDB
Verifica que a .env les variables DB_* siguin correctes.
Assegura’t que el backend usa el nom del servei mariadb (no localhost).
📦 Distribució i seguretat
No incloguis mai el fitxer .env en arxius compartits, repositoris o còpies de seguretat.
Per compartir aquest entorn, només envia la carpeta sense .env, i inclou sempre .env.example.
📞 Suport
Per dubtes o incidències, contacta amb l’administrador del sistema (sol.licituds@pirolab.cat).
🌱 Aquest entorn està dissenyat per a desenvolupament i proves. Per a producció, revisa la configuració de seguretat.
Per descarregar la última versió del client: http://pirolab.cat/index.php/download/frontend-pirolab-0-0-3/
Per descarregar la última versió del backend: http://pirolab.cat/index.php/download/backend-pirolab-0-0-3/