Skip to main content

Custom Docker Images

Application Archive​

Download and extract the application archive:

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

The archive contains the following directories:

  • backend - core application logic
  • api-gateway - handles user authentication
  • frontend - user interface (static HTML, JavaScript and CSS files)

Building Docker Images​

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

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

Required Services​

The application needs three more services:

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

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

Running the Containers​

Set environment variables for the containers. The .env.example files in the archive list them per container.

Start the containers:

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