Installation and Configuration

Step 1. Obtaining the Distribution Package

Obtain the software archive:

blast4d-compose-develop.zip

Step 2. Extraction

Extract the archive and navigate to the project directory:

unzip blast4d-compose-develop.zip
cd blast4d-compose-develop

Step 3. Verifying the Project Structure

Ensure the directory structure matches the expected layout:

blast4d-compose-develop/
├── services/                 # Backend microservices (FastAPI)
├── frontend/                 # Interface (Next.js)
├── shared/                   # Shared modules
├── database/                 # SQL schemas
├── keycloak/                 # Authentication
├── nginx/                    # Reverse proxy configuration
├── scripts/                  # Deployment scripts
├── docker-compose.yml
├── docker-compose.dev.yml
├── .env.local                # Environment variables template
└── ЗАПУСК_СИСТЕМЫ.md         # Main startup guide

Step 4. Configuring Environment Variables

Create a working environment file from the template:

cp .env.local .env

info

All required Docker images and configurations are already included in the archive. Downloading from an external Docker registry is not required.

System Components

The Взрыв4D system includes the following components deployed via Docker Compose:

Component	Description
Frontend	Web interface built on Next.js
API Gateway	API request routing
Computation Services	Backend modeling microservices
PostgreSQL	Relational database
MinIO	Object file storage
Keycloak	Authentication server
Nginx	Reverse proxy
Redis	Caching and task queues

Dependencies

All dependencies are installed inside containers automatically during the build process. Manual installation of Python, Node.js, or any libraries is not required.