Skip to content

Prerequisites

Before you begin working with the Dataspace Ecosystem, ensure you have the following prerequisites installed and configured.

System Requirements

Hardware

Component Minimum Recommended
CPU 4 cores 8+ cores
RAM 8 GB 16+ GB
Disk 20 GB 50+ GB SSD

Operating System

  • macOS 12+ (Monterey or later)
  • Linux (Ubuntu 20.04+, Debian 11+, RHEL 8+)
  • Windows 10/11 with WSL2

Required Software

Java Development Kit (JDK)

Version: JDK 17 or later (LTS recommended)

brew install openjdk@17
export JAVA_HOME=/opt/homebrew/opt/openjdk@17

sudo apt update
sudo apt install openjdk-17-jdk

Download from Adoptium or use: 

winget install EclipseAdoptium.Temurin.17.JDK

Verify installation: 

java -version

Gradle

Version: 8.0 or later

The project includes Gradle wrapper, so manual installation is optional:

./gradlew --version

Docker or Podman

Version: Docker 20.10+ / Podman 4.0+ (with Docker Compose 2.0+ or Podman Compose)

Either Docker or Podman can be used as the container runtime.

brew install --cask docker

Follow Docker Engine installation

Download Docker Desktop

brew install podman
podman machine init
podman machine start

# Fedora/RHEL
sudo dnf install podman podman-compose

# Ubuntu/Debian
sudo apt install podman podman-compose

Verify installation: 

# Docker
docker --version
docker compose version

# Or Podman
podman --version
podman-compose --version

Kubernetes (Optional)

For Kubernetes deployment:

  • kubectl: v1.25+
  • Helm: v3.10+
  • Kind or Minikube: For local clusters
# Install kubectl
brew install kubectl

# Install Helm
brew install helm

# Install Kind
brew install kind

Terraform (Optional)

For infrastructure provisioning:

brew install terraform
terraform --version

Development Tools

IDE

Any IDE with Java support can be used. Below are two popular options for which we provide setup instructions in the Development Setup guide:

Git

git --version

Network Requirements

Ensure these ports are available:

Port Service
8080-8090 Control Plane APIs
8180-8190 Data Plane APIs
8280-8290 Identity Hub APIs
5432 PostgreSQL
9200 Elasticsearch

Environment Setup

Clone Repository

git clone https://github.com/AmadeusITGroup/dataspace-ecosystem/
cd dataspace-ecosystem

Verify Build

./gradlew build

Next Steps