{"id":200,"date":"2025-12-16T11:28:59","date_gmt":"2025-12-16T09:28:59","guid":{"rendered":"http:\/\/pirolab.cat\/?page_id=200"},"modified":"2025-12-16T12:22:51","modified_gmt":"2025-12-16T10:22:51","slug":"downloads","status":"publish","type":"page","link":"https:\/\/pirolab.cat\/index.php\/en\/downloads\/","title":{"rendered":"Downloads"},"content":{"rendered":"\n<p>Here you will find the available versions of Pirolab, both client and server, as well as the necessary instructions to start the application.<\/p>\n\n\n\n<p>For Pirolab to work, a PIROLAB server must be installed either on your local machine or on a machine within your local network. The operating system of the server machine is irrelevant, as the application is distributed via a Docker image.<\/p>\n\n\n\n<p>The client application is currently configured to run on Windows, although a Linux version will be released in future versions.<\/p>\n\n\n\n<p>To use the application, both the server and the client must be installed.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Install the client<\/h3>\n\n\n\n<p>To install the client, simply unzip the ZIP file and double-click the installer. Once the installation process starts, follow the on-screen instructions.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"570\" height=\"436\" src=\"http:\/\/pirolab.cat\/wp-content\/uploads\/2025\/12\/image-15.png\" alt=\"\" class=\"wp-image-262\" style=\"width:462px;height:auto\" srcset=\"https:\/\/pirolab.cat\/wp-content\/uploads\/2025\/12\/image-15.png 570w, https:\/\/pirolab.cat\/wp-content\/uploads\/2025\/12\/image-15-300x229.png 300w\" sizes=\"auto, (max-width: 570px) 100vw, 570px\" \/><\/figure>\n<\/div>\n\n\n<p>You can create a shortcut on the desktop or in the Windows start menu. Once the installation is complete, you can launch the application with a double click.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"371\" height=\"462\" src=\"http:\/\/pirolab.cat\/wp-content\/uploads\/2025\/12\/image-17.png\" alt=\"\" class=\"wp-image-265\" style=\"width:279px;height:auto\" srcset=\"https:\/\/pirolab.cat\/wp-content\/uploads\/2025\/12\/image-17.png 371w, https:\/\/pirolab.cat\/wp-content\/uploads\/2025\/12\/image-17-241x300.png 241w\" sizes=\"auto, (max-width: 371px) 100vw, 371px\" \/><\/figure>\n<\/div>\n\n\n<p><br>If there is no connection to the server, a warning message will be displayed.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Install the backend<\/h3>\n\n\n\n<p>The backend is distributed as a Docker image, therefore Docker must be installed in order to install the Pirolab server. Docker installation instructions can be found on the official website:<br><a href=\"https:\/\/www.docker.com\/\">https:\/\/www.docker.com\/<\/a><\/p>\n\n\n\n<p>Once Docker is installed on the machine where you want to run the Pirolab backend, download the corresponding <code>backend-pirolab-x-x-x<\/code> package.<\/p>\n\n\n\n<p>This package contains everything needed to run a complete local environment with:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Spring Boot (backend at <a href=\"http:\/\/localhost:8090\">http:\/\/localhost:8090<\/a>)<\/li>\n\n\n\n<li>OpenProdoc (document management system at <a href=\"http:\/\/localhost:8080\">http:\/\/localhost:8080<\/a>)<\/li>\n\n\n\n<li>MariaDB (database)<\/li>\n<\/ul>\n\n\n\n<p>All components are containerized using Docker and can be installed on any system with Docker installed.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Initial configuration<\/h3>\n\n\n\n<p>First, edit the <code>.env<\/code> file with your credentials:<\/p>\n\n\n\n<pre class=\"wp-block-code has-small-font-size\"><code>DB_ROOT_PASSWORD=your_root_password<br>DB_NAME=PIROLAB<br>DB_USER=pirolab<br>DB_PASSWORD=your_user_password<\/code><\/pre>\n\n\n\n<p>\ud83d\udd10 This file must never be shared. It contains sensitive information.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Startup<\/h3>\n\n\n\n<p>From the project folder (<code>pirolab\/<\/code>), run:<\/p>\n\n\n\n<pre class=\"wp-block-code has-small-font-size\"><code>docker compose up --build -d<\/code><\/pre>\n\n\n\n<p>\u23f1\ufe0f The first execution may take between 2 and 5 minutes (image build and MariaDB download).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Service access<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>OpenProdoc: http:\/\/localhost:8080<\/li>\n\n\n\n<li>Spring Boot: http:\/\/localhost:8090<\/li>\n\n\n\n<li>MariaDB: localhost:3306<\/li>\n<\/ul>\n\n\n\n<p>\u2705 Documents and database data are preserved between restarts thanks to Docker volumes.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Stop the environment<\/h3>\n\n\n\n<pre class=\"wp-block-code has-small-font-size\"><code>docker compose down<\/code><\/pre>\n\n\n\n<p>\u26a0\ufe0f This stops the containers but keeps all data (documents, database, etc.).<\/p>\n\n\n\n<p>To remove everything (including data):<\/p>\n\n\n\n<pre class=\"wp-block-code has-small-font-size\"><code>docker compose down -v<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Update the application<\/h3>\n\n\n\n<p>If you update the Spring Boot or OpenProdoc code:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li class=\"has-small-font-size\">Replace the <code>springboot\/your-app.jar<\/code> file or the OpenProdoc files.<\/li>\n\n\n\n<li class=\"has-small-font-size\">Rebuild the environment:<\/li>\n<\/ol>\n\n\n\n<pre class=\"wp-block-code has-small-font-size\"><code>docker compose up --build -d<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Project structure<\/h3>\n\n\n\n<pre class=\"wp-block-code has-small-font-size\"><code>pirolab\/<br>\u251c\u2500\u2500 docker-compose.yml # Service definitions<br>\u251c\u2500\u2500 .env.example # Configuration template<br>\u251c\u2500\u2500 .env # \u2190 Create this file (not distributed)<br>\u251c\u2500\u2500 springboot\/ # Spring Boot backend<br>\u2502 \u251c\u2500\u2500 Dockerfile<br>\u2502 \u2514\u2500\u2500 your-app.jar<br>\u2514\u2500\u2500 openprodoc\/ # Document management system<br>\u251c\u2500\u2500 Dockerfile<br>\u2514\u2500\u2500 (application files)<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Common troubleshooting<\/h3>\n\n\n\n<p>\ud83d\udd38 <strong>&#8220;Access denied for user &#8216;xxx&#8217;@&#8217;\u2026'&#8221;<\/strong><br>Make sure the credentials in the <code>.env<\/code> file match those used by the backend.<br>If this is the first installation, do not run <code>docker compose down -v<\/code> after installing OpenProdoc.<\/p>\n\n\n\n<p>\ud83d\udd38 <strong>OpenProdoc does not load<\/strong><br>Wait about 30 seconds the first time (startup may take longer).<br>Check the logs:<\/p>\n\n\n\n<pre class=\"wp-block-code has-small-font-size\"><code>docker logs openprodoc<\/code><\/pre>\n\n\n\n<p>\ud83d\udd38 <strong>Spring Boot cannot connect to MariaDB<\/strong><br>Verify that the <code>DB_*<\/code> variables in the <code>.env<\/code> file are correct.<br>Ensure the backend uses the service name <code>mariadb<\/code> instead of <code>localhost<\/code>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Distribution and security<\/h3>\n\n\n\n<p>Never include the <code>.env<\/code> file in shared files, repositories, or backups.<br>To share this environment, send the folder without the <code>.env<\/code> file and always include <code>.env.example<\/code>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Support<\/h3>\n\n\n\n<p>For questions or issues, contact the system administrator:<br>\ud83d\udce7 <strong><a>sol.licituds@pirolab.cat<\/a><\/strong><\/p>\n\n\n\n<p>\ud83c\udf31 This environment is designed for development and testing. For production use, review the security configuration.<\/p>\n\n\n\n<p><strong>Download the latest client version:<\/strong> <a href=\"http:\/\/pirolab.cat\/index.php\/download\/frontend-pirolab-0-0-2\/\">http:\/\/pirolab.cat\/index.php\/download\/frontend-pirolab-0-0-2\/<\/a><\/p>\n\n\n\n<p><strong>Download the latest backend version:<\/strong> <a href=\"http:\/\/pirolab.cat\/index.php\/download\/backend-pirolab-0-0-2\/\">http:\/\/pirolab.cat\/index.php\/download\/backend-pirolab-0-0-2\/<\/a><\/p>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Here you will find the available versions of Pirolab, both client and server, as well as the necessary instructions to start the application. For Pirolab to work, a PIROLAB server must be installed either on your local machine or on a machine within your local network. The operating system of the server machine is irrelevant, as the application is distributed via a Docker image. The client application is currently configured&hellip;<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-200","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.5 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Downloads - Pirolab<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/pirolab.cat\/index.php\/en\/downloads\/\" \/>\n<meta property=\"og:locale\" content=\"ca_ES\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Downloads - Pirolab\" \/>\n<meta property=\"og:description\" content=\"Here you will find the available versions of Pirolab, both client and server, as well as the necessary instructions to start the application. For Pirolab to work, a PIROLAB server must be installed either on your local machine or on a machine within your local network. The operating system of the server machine is irrelevant, as the application is distributed via a Docker image. The client application is currently configured&hellip;\" \/>\n<meta property=\"og:url\" content=\"https:\/\/pirolab.cat\/index.php\/en\/downloads\/\" \/>\n<meta property=\"og:site_name\" content=\"Pirolab\" \/>\n<meta property=\"article:modified_time\" content=\"2025-12-16T10:22:51+00:00\" \/>\n<meta property=\"og:image\" content=\"http:\/\/pirolab.cat\/wp-content\/uploads\/2025\/12\/image-15.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Temps estimat de lectura\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minuts\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/pirolab.cat\\\/index.php\\\/en\\\/downloads\\\/\",\"url\":\"https:\\\/\\\/pirolab.cat\\\/index.php\\\/en\\\/downloads\\\/\",\"name\":\"Downloads - Pirolab\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/pirolab.cat\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/pirolab.cat\\\/index.php\\\/en\\\/downloads\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/pirolab.cat\\\/index.php\\\/en\\\/downloads\\\/#primaryimage\"},\"thumbnailUrl\":\"http:\\\/\\\/pirolab.cat\\\/wp-content\\\/uploads\\\/2025\\\/12\\\/image-15.png\",\"datePublished\":\"2025-12-16T09:28:59+00:00\",\"dateModified\":\"2025-12-16T10:22:51+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/pirolab.cat\\\/index.php\\\/en\\\/downloads\\\/#breadcrumb\"},\"inLanguage\":\"ca\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/pirolab.cat\\\/index.php\\\/en\\\/downloads\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"ca\",\"@id\":\"https:\\\/\\\/pirolab.cat\\\/index.php\\\/en\\\/downloads\\\/#primaryimage\",\"url\":\"https:\\\/\\\/pirolab.cat\\\/wp-content\\\/uploads\\\/2025\\\/12\\\/image-15.png\",\"contentUrl\":\"https:\\\/\\\/pirolab.cat\\\/wp-content\\\/uploads\\\/2025\\\/12\\\/image-15.png\",\"width\":570,\"height\":436},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/pirolab.cat\\\/index.php\\\/en\\\/downloads\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"http:\\\/\\\/pirolab.cat\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Downloads\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/pirolab.cat\\\/#website\",\"url\":\"https:\\\/\\\/pirolab.cat\\\/\",\"name\":\"Pirolab\",\"description\":\"Gestor de Laboratoris de Geotecnia\",\"publisher\":{\"@id\":\"https:\\\/\\\/pirolab.cat\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/pirolab.cat\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"ca\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/pirolab.cat\\\/#organization\",\"name\":\"Pirolab\",\"url\":\"https:\\\/\\\/pirolab.cat\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"ca\",\"@id\":\"https:\\\/\\\/pirolab.cat\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"http:\\\/\\\/pirolab.cat\\\/wp-content\\\/uploads\\\/2022\\\/07\\\/logo.png\",\"contentUrl\":\"http:\\\/\\\/pirolab.cat\\\/wp-content\\\/uploads\\\/2022\\\/07\\\/logo.png\",\"width\":183,\"height\":70,\"caption\":\"Pirolab\"},\"image\":{\"@id\":\"https:\\\/\\\/pirolab.cat\\\/#\\\/schema\\\/logo\\\/image\\\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Downloads - Pirolab","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/pirolab.cat\/index.php\/en\/downloads\/","og_locale":"ca_ES","og_type":"article","og_title":"Downloads - Pirolab","og_description":"Here you will find the available versions of Pirolab, both client and server, as well as the necessary instructions to start the application. For Pirolab to work, a PIROLAB server must be installed either on your local machine or on a machine within your local network. The operating system of the server machine is irrelevant, as the application is distributed via a Docker image. The client application is currently configured&hellip;","og_url":"https:\/\/pirolab.cat\/index.php\/en\/downloads\/","og_site_name":"Pirolab","article_modified_time":"2025-12-16T10:22:51+00:00","og_image":[{"url":"http:\/\/pirolab.cat\/wp-content\/uploads\/2025\/12\/image-15.png","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Temps estimat de lectura":"4 minuts"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/pirolab.cat\/index.php\/en\/downloads\/","url":"https:\/\/pirolab.cat\/index.php\/en\/downloads\/","name":"Downloads - Pirolab","isPartOf":{"@id":"https:\/\/pirolab.cat\/#website"},"primaryImageOfPage":{"@id":"https:\/\/pirolab.cat\/index.php\/en\/downloads\/#primaryimage"},"image":{"@id":"https:\/\/pirolab.cat\/index.php\/en\/downloads\/#primaryimage"},"thumbnailUrl":"http:\/\/pirolab.cat\/wp-content\/uploads\/2025\/12\/image-15.png","datePublished":"2025-12-16T09:28:59+00:00","dateModified":"2025-12-16T10:22:51+00:00","breadcrumb":{"@id":"https:\/\/pirolab.cat\/index.php\/en\/downloads\/#breadcrumb"},"inLanguage":"ca","potentialAction":[{"@type":"ReadAction","target":["https:\/\/pirolab.cat\/index.php\/en\/downloads\/"]}]},{"@type":"ImageObject","inLanguage":"ca","@id":"https:\/\/pirolab.cat\/index.php\/en\/downloads\/#primaryimage","url":"https:\/\/pirolab.cat\/wp-content\/uploads\/2025\/12\/image-15.png","contentUrl":"https:\/\/pirolab.cat\/wp-content\/uploads\/2025\/12\/image-15.png","width":570,"height":436},{"@type":"BreadcrumbList","@id":"https:\/\/pirolab.cat\/index.php\/en\/downloads\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"http:\/\/pirolab.cat\/"},{"@type":"ListItem","position":2,"name":"Downloads"}]},{"@type":"WebSite","@id":"https:\/\/pirolab.cat\/#website","url":"https:\/\/pirolab.cat\/","name":"Pirolab","description":"Gestor de Laboratoris de Geotecnia","publisher":{"@id":"https:\/\/pirolab.cat\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/pirolab.cat\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"ca"},{"@type":"Organization","@id":"https:\/\/pirolab.cat\/#organization","name":"Pirolab","url":"https:\/\/pirolab.cat\/","logo":{"@type":"ImageObject","inLanguage":"ca","@id":"https:\/\/pirolab.cat\/#\/schema\/logo\/image\/","url":"http:\/\/pirolab.cat\/wp-content\/uploads\/2022\/07\/logo.png","contentUrl":"http:\/\/pirolab.cat\/wp-content\/uploads\/2022\/07\/logo.png","width":183,"height":70,"caption":"Pirolab"},"image":{"@id":"https:\/\/pirolab.cat\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/pirolab.cat\/index.php\/wp-json\/wp\/v2\/pages\/200","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pirolab.cat\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/pirolab.cat\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/pirolab.cat\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/pirolab.cat\/index.php\/wp-json\/wp\/v2\/comments?post=200"}],"version-history":[{"count":2,"href":"https:\/\/pirolab.cat\/index.php\/wp-json\/wp\/v2\/pages\/200\/revisions"}],"predecessor-version":[{"id":266,"href":"https:\/\/pirolab.cat\/index.php\/wp-json\/wp\/v2\/pages\/200\/revisions\/266"}],"wp:attachment":[{"href":"https:\/\/pirolab.cat\/index.php\/wp-json\/wp\/v2\/media?parent=200"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}