Skip to content

Prerequisites Windows

This page lists the tools and dependencies required to build and run OpenAEV from source on Windows.

Backend

Java 21

Install OpenJDK 21 or later. Download from Adoptium or use a package manager:

winget install EclipseAdoptium.Temurin.21.JDK

Verify the installation:

java -version

Maven

Install Apache Maven 3.9 or later. Download from maven.apache.org or use a package manager:

winget install Apache.Maven

Verify the installation:

mvn -version

Docker Desktop

Docker Desktop is required to run the development services (PostgreSQL, Elasticsearch, RabbitMQ, MinIO).

  1. Download and install Docker Desktop for Windows.
  2. Enable the WSL 2 backend for better performance (recommended).
  3. Verify the installation:
docker --version
docker compose version

Git

Install Git for Windows:

winget install Git.Git

Frontend

Node.js

Install Node.js 22 or later. Use nvm-windows to manage versions:

  1. Download and install nvm-windows from the releases page.
  2. Install and activate Node.js 22:
nvm install 22
nvm use 22

Yarn

OpenAEV uses Yarn 4. After installing Node.js, enable Corepack:

corepack enable

Yarn is bundled with the repository and will be used automatically when running yarn commands inside openaev-front/.

Development services

Start the backend dependencies with Docker Compose:

cd openaev-dev
docker compose up -d openaev-dev-pgsql openaev-dev-minio openaev-dev-elasticsearch openaev-dev-rabbitmq

This starts:

Service Port Description
PostgreSQL 17 5432 Database
MinIO 10000, 10001 S3-compatible object storage
Elasticsearch 8 9200 Analytics engine
RabbitMQ 4 5672, 15672 Message broker

Warning

Ensure these ports are not already in use on your machine before starting the services.

What's next?