Skip to main content

Custom Docker Images

Getting the Components​

Download and extract the application archive:

wget https://nexus.architeezy.com/repository/delivery/architeezy/architeezy-2025.2.0.zip
unzip architeezy-2025.2.0.zip
cd architeezy-2025.2.0

The archive contains the following directories:

  • api-gateway — handles user authentication (requires JDK 21+)
  • backend — core application logic (requires JDK 21+)
  • frontend — user interface (static HTML/JS/CSS files)

Building Docker Images​

Use the provided Dockerfiles from the archive or create your own, then run:

docker build -t architeezy-backend:2026.2.0 -t architeezy-backend:latest backend
docker build -t architeezy-api-gateway:2026.2.0 -t architeezy-api-gateway:latest api-gateway
docker build -t architeezy-frontend:2026.2.0 -t architeezy-frontend:latest frontend

Dependencies​

The application requires additional services:

  • PostgreSQL 18+ — application database
  • Redis — session cache that keeps users logged in after restarts
  • Keycloak — user authentication

An example configuration is available in the architeezy-selfhosted repository.

Running the Application​

Set environment variables for the containers. You can use the .env.example files from the archive as a reference.

Start the containers:

docker run -p 8082:8082 --env-file backend/.env.example --add-host=host.docker.internal:host-gateway architeezy-backend:2026.2.0
docker run -p 8081:8081 --env-file api-gateway/.env.example --add-host=host.docker.internal:host-gateway architeezy-api-gateway:2026.2.0
docker run -p 8080:80 --env-file frontend/.env.example --add-host=host.docker.internal:host-gateway architeezy-frontend:2026.2.0