Before you start a single-node or multi-node GuancheData deployment, every machine that will participate in the cluster must have the same set of tools installed. The build pipeline relies on Java and Maven to compile the microservices into executable JARs, while Docker Compose handles image building and container orchestration at runtime. The steps below walk you through installing and verifying each dependency.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/GuancheData/stage_3/llms.txt
Use this file to discover all available pages before exploring further.
Install Java JDK 17
GuancheData services are compiled and run on Java 17. Download the JDK from your distribution’s package manager or from Adoptium. After installation, confirm the version:Expected output (version number may vary within the 17.x line):
Install Apache Maven 3.6+
The project uses a multi-module Maven build. Maven 3.6 or later is required. Verify the installed version:Expected output:The output also confirms which JDK Maven is using. Both lines must reflect version 17.
Install Docker Desktop
Docker Compose is used to build container images and run all services. Install Docker Desktop (which bundles the Compose plugin) for your operating system from docker.com.Verify the Docker daemon is running and the Compose plugin is available:Expected output:
No separate
docker build step is needed. Docker Compose handles both image building and container startup automatically when you run docker compose up.All nodes in a multi-node deployment must have Java JDK 17, Maven 3.6+, and Docker Desktop installed. The Maven build only needs to run on one machine (the machine where you clone the repository), but Docker must be present and running on every node that will host containers.