Docker Configuration

Overview

The IRA FORCE platform is fully containerized with the following services:

Local Development Setup

Use Docker Compose to spin up the complete development environment.

Quick Start Commands

# Clone the repository
git clone git@github.com:iraforce/platform.git
cd platform

# Copy environment template
cp .env.example .env

# Start all services
docker compose up -d

# View logs
docker compose logs -f api

# Stop all services
docker compose down

For detailed Docker Compose configuration, see the repository:

View docker-compose.yml on GitHub →

Docker Images

All IRA FORCE images are stored in our private container registry.

Building Images

Build images locally for development or testing.

# Build a specific service
docker build -t iraforce/api:local -f docker/api/Dockerfile .

# Build all services
docker compose build

# Build with no cache
docker compose build --no-cache api

Multi-stage Builds

All Dockerfiles use multi-stage builds to minimize image size. The production images are based on node:20-alpine for optimal performance.

View Dockerfiles on GitHub →

Volumes & Data Persistence

Named volumes are used to persist data across container restarts.

# List volumes
docker volume ls | grep iraforce

# Remove all volumes (⚠️ destroys data)
docker compose down -v

Networking

Services communicate over a custom bridge network.

# Network configuration
networks:
  iraforce-network:
    driver: bridge
    ipam:
      config:
        - subnet: 172.28.0.0/16

Service Discovery

Services can communicate using container names as hostnames:

• http://api:3000 - Core API
• http://soc:3001 - SOC Service
• postgres://db:5432 - Database
• redis://redis:6379 - Redis

Health Checks

All services include health check endpoints for container orchestration.

# Example health check configuration
healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
  interval: 30s
  timeout: 10s
  retries: 3
  start_period: 40s

Health endpoints:

• GET /health - Basic health check
• GET /health/ready - Readiness probe
• GET /health/live - Liveness probe

Kubernetes Deployment

Production deployments use Kubernetes managed through ArgoCD.

Troubleshooting

Common Issues

# Check logs
docker compose logs api

# Inspect container
docker inspect iraforce-api-1

# Find process using port
lsof -i :3000

# Or change port in .env
APP_PORT=3001

# Wait for database to be ready
docker compose up -d db
docker compose logs -f db

# Then start other services
docker compose up -d

Related Resources