Skip to content

1. Preparing your environment

Most of the workshop exercises involves usage of tools such as: - Developer IDE (e.g. VSCode, Eclipse, IntelliJ, ...) - Egon.io - CLI tools via terminal - Maven - Docker - Docker Compose - Postman (Optional)

1.1 Prerequisites

  • Maven CLI;
  • Git CLI;
  • Java 21;
  • An IDE of your preference;
  • Command line (terminal). If using Windows, PowerShell is recommended;
  • REST client tools like cURL or postman (Optional);
  • Docker and Docker Compose.
  • Postman (Optional)
java -version
mvn -version
git --version

To validate your environment, confirm you have as an output of the commands above working: 

$ java -version
openjdk version "21.0.7" 2025-04-15 LTS
OpenJDK Runtime Environment Temurin-21.0.7+6 (build 21.0.7+6-LTS)
OpenJDK 64-Bit Server VM Temurin-21.0.7+6 (build 21.0.7+6-LTS, mixed mode, sharing)


$ mvn -version
Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
Maven home: /Users/otaviosantana/.sdkman/candidates/maven/current
Java version: 21.0.7, vendor: Eclipse Adoptium, runtime: /Users/otaviosantana/.sdkman/candidates/java/21.0.7-tem
Default locale: en_US, platform encoding: UTF-8
OS name: "mac os x", version: "15.6.1", arch: "aarch64", family: "mac"

$ git --version
git version 2.39.5 (Apple Git-154)

$ docker --version
Docker version 28.3.2, build 578ccf6

$ docker compose version
Docker Compose version v2.39.1-desktop.1

1.2 Prepare your working directory

To get started with the labs, first you need to clone the projects used in the exercises and have it available in your local development environment.

Info

The guided exercises are built on top of quickstart projects, a foundation set of preconfigured projects.

To get the foundation projects and build them, execute: 

git clone https://github.com/ultimate-engineer/ddd-workshop-labs
cd ddd-workshop-labs
mvn clean package
docker-compose up -d

The build and packaging should complete successfully.

Last update: 2025-09-05