Fixed the docker process to be able run the application.

Author: Ruslan Baidan

.env.dev

@@ -4,3 +4,13 @@ DBNAME_COMMON=monarc_common
 DBNAME_MASTER=monarc_master
 DBUSER_MONARC=sqlmonarcuser
 DBPASSWORD_MONARC=sqlmonarcuser
+
+# Optional: set to 0/false/no to disable Xdebug in the image build
+XDEBUG_ENABLED=1
+XDEBUG_MODE=debug
+XDEBUG_START_WITH_REQUEST=trigger
+# On Linux, set XDEBUG_CLIENT_HOST to your Docker bridge (often 172.17.0.1).
+XDEBUG_CLIENT_HOST=host.docker.internal
+XDEBUG_CLIENT_PORT=9003
+XDEBUG_IDEKEY=IDEKEY
+XDEBUG_DISCOVER_CLIENT_HOST=0

.gitignore

@@ -22,3 +22,4 @@ vagrant/.vagrant/
 vagrant/*.log
 .env
 .docker-initialized
+docker/db_data

.vscode/launch.json

@@ -0,0 +1,58 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Attach to Chrome",
+            "port": 9222,
+            "request": "attach",
+            "type": "chrome",
+            "webRoot": "${workspaceFolder}"
+        },
+        {
+            "name": "Listen for Xdebug",
+            "type": "php",
+            "request": "launch",
+            "port": 9003,
+            "pathMappings": {
+                "/var/www/html/monarc": "${workspaceFolder}"
+            }
+        },
+        {
+            "name": "Launch currently open script",
+            "type": "php",
+            "request": "launch",
+            "program": "${file}",
+            "cwd": "${fileDirname}",
+            "port": 0,
+            "runtimeArgs": [
+                "-dxdebug.start_with_request=yes"
+            ],
+            "env": {
+                "XDEBUG_MODE": "debug,develop",
+                "XDEBUG_CONFIG": "client_port=${port}"
+            }
+        },
+        {
+            "name": "Launch Built-in web server",
+            "type": "php",
+            "request": "launch",
+            "runtimeArgs": [
+                "-dxdebug.mode=debug",
+                "-dxdebug.start_with_request=yes",
+                "-S",
+                "localhost:0"
+            ],
+            "program": "",
+            "cwd": "${workspaceRoot}",
+            "port": 9003,
+            "serverReadyAction": {
+                "pattern": "Development Server \\(http://localhost:([0-9]+)\\) started",
+                "uriFormat": "http://localhost:%s",
+                "action": "openExternally"
+            }
+        }
+    ]
+}

Dockerfile

@@ -1,5 +1,13 @@
 FROM ubuntu:22.04
 
+ARG XDEBUG_ENABLED=1
+ARG XDEBUG_MODE=debug
+ARG XDEBUG_START_WITH_REQUEST=trigger
+ARG XDEBUG_CLIENT_HOST=host.docker.internal
+ARG XDEBUG_CLIENT_PORT=9003
+ARG XDEBUG_IDEKEY=IDEKEY
+ARG XDEBUG_DISCOVER_CLIENT_HOST=0
+
 # Prevent interactive prompts during package installation
 ENV DEBIAN_FRONTEND=noninteractive
 ENV LANGUAGE=en_US.UTF-8
@@ -8,33 +16,13 @@ ENV LC_ALL=en_US.UTF-8
 
 # Install system dependencies
 RUN apt-get update && apt-get upgrade -y && \
-    apt-get install -y \
-    vim \
-    zip \
-    unzip \
-    git \
-    gettext \
-    curl \
-    gsfonts \
-    mariadb-client \
-    apache2 \
-    php8.1 \
-    php8.1-cli \
-    php8.1-common \
-    php8.1-mysql \
-    php8.1-zip \
-    php8.1-gd \
-    php8.1-mbstring \
-    php8.1-curl \
-    php8.1-xml \
-    php8.1-bcmath \
-    php8.1-intl \
-    php8.1-imagick \
-    php8.1-xdebug \
-    locales \
-    wget \
-    ca-certificates \
-    gnupg && \
+    packages="vim zip unzip git gettext curl gsfonts mariadb-client apache2 php8.1 php8.1-cli \
+    php8.1-common php8.1-mysql php8.1-zip php8.1-gd php8.1-mbstring php8.1-curl php8.1-xml \
+    php8.1-bcmath php8.1-intl php8.1-imagick locales wget ca-certificates gnupg"; \
+    if [ "$XDEBUG_ENABLED" = "1" ] || [ "$XDEBUG_ENABLED" = "true" ] || [ "$XDEBUG_ENABLED" = "yes" ]; then \
+        packages="$packages php8.1-xdebug"; \
+    fi; \
+    apt-get install -y $packages && \
     locale-gen en_US.UTF-8 && \
     apt-get clean && \
     rm -rf /var/lib/apt/lists/*
@@ -50,23 +38,32 @@ RUN sed -i 's/upload_max_filesize = .*/upload_max_filesize = 200M/' /etc/php/8.1
     sed -i 's/session\\.gc_divisor = .*/session.gc_divisor = 1000/' /etc/php/8.1/apache2/php.ini
 
 # Configure Xdebug for development
-RUN echo "zend_extension=xdebug.so" > /etc/php/8.1/apache2/conf.d/20-xdebug.ini && \
-    echo "xdebug.mode=debug" >> /etc/php/8.1/apache2/conf.d/20-xdebug.ini && \
-    echo "xdebug.discover_client_host=1" >> /etc/php/8.1/apache2/conf.d/20-xdebug.ini && \
-    echo "xdebug.idekey=IDEKEY" >> /etc/php/8.1/apache2/conf.d/20-xdebug.ini
+RUN if [ "$XDEBUG_ENABLED" = "1" ] || [ "$XDEBUG_ENABLED" = "true" ] || [ "$XDEBUG_ENABLED" = "yes" ]; then \
+        echo "zend_extension=xdebug.so" > /etc/php/8.1/apache2/conf.d/20-xdebug.ini && \
+        echo "xdebug.mode=${XDEBUG_MODE}" >> /etc/php/8.1/apache2/conf.d/20-xdebug.ini && \
+        echo "xdebug.start_with_request=${XDEBUG_START_WITH_REQUEST}" >> /etc/php/8.1/apache2/conf.d/20-xdebug.ini && \
+        echo "xdebug.client_host=${XDEBUG_CLIENT_HOST}" >> /etc/php/8.1/apache2/conf.d/20-xdebug.ini && \
+        echo "xdebug.client_port=${XDEBUG_CLIENT_PORT}" >> /etc/php/8.1/apache2/conf.d/20-xdebug.ini && \
+        echo "xdebug.discover_client_host=${XDEBUG_DISCOVER_CLIENT_HOST}" >> /etc/php/8.1/apache2/conf.d/20-xdebug.ini && \
+        echo "xdebug.idekey=${XDEBUG_IDEKEY}" >> /etc/php/8.1/apache2/conf.d/20-xdebug.ini; \
+    fi
 
 # Enable Apache modules
 RUN a2enmod rewrite ssl headers
 
+# Set global ServerName to avoid AH00558 warning
+RUN echo "ServerName localhost" > /etc/apache2/conf-available/servername.conf \
+    && a2enconf servername
+
 # Install Composer
 RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
 
 # Install Node.js and npm
 RUN mkdir -p /etc/apt/keyrings && \
     curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg && \
-    echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_15.x nodistro main" > /etc/apt/sources.list.d/nodesource.list && \
+    echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x nodistro main" > /etc/apt/sources.list.d/nodesource.list && \
     apt-get update && \
-    apt-get install -y nodejs npm && \
+    apt-get install -y nodejs && \
     npm install -g grunt-cli && \
     apt-get clean && \
     rm -rf /var/lib/apt/lists/*

INSTALL/INSTALL.docker.md

@@ -9,8 +9,10 @@ This document provides installation instructions for setting up MONARC BackOffic
 git clone https://github.com/monarc-project/MonarcAppBO
 cd MonarcAppBO
 
-# Start with the helper script (recommended)
-./docker-dev.sh start
+# Start with Makefile (recommended)
+make start
+# Optional: use ENV to select docker-compose.<ENV>.yml (default: dev)
+# make start ENV=prod
 
 # Or use docker-compose directly
 cp .env.dev .env
@@ -97,7 +99,7 @@ chmod -R 775 /var/www/html/monarc/data
 Check the logs:
 
 ```bash
-./docker-dev.sh logs
+make logs
 # or
 docker compose -f docker-compose.dev.yml logs
 ```
@@ -107,7 +109,7 @@ docker compose -f docker-compose.dev.yml logs
 To start completely fresh:
 
 ```bash
-./docker-dev.sh reset
+make reset
 # or
 docker compose -f docker-compose.dev.yml down -v
 ```
@@ -116,27 +118,27 @@ docker compose -f docker-compose.dev.yml down -v
 
 ### View Logs
 ```bash
-./docker-dev.sh logs
+make logs
 ```
 
 ### Access Container Shell
 ```bash
-./docker-dev.sh shell
+make shell
 ```
 
 ### Access Database
 ```bash
-./docker-dev.sh db
+make db
 ```
 
 ### Stop Services
 ```bash
-./docker-dev.sh stop
+make stop
 ```
 
 ### Restart Services
 ```bash
-./docker-dev.sh restart
+make restart
 ```
 
 ## Comparison with Other Installation Methods

Makefile

@@ -0,0 +1,85 @@
+.DEFAULT_GOAL := help
+
+SHELL := /bin/bash
+
+ENV ?= dev
+COMPOSE_FILE ?= docker-compose.$(ENV).yml
+COMPOSE := docker compose -f $(COMPOSE_FILE)
+
+GREEN := \033[0;32m
+YELLOW := \033[1;33m
+RED := \033[0;31m
+NC := \033[0m
+
+.PHONY: help check-env start stop restart logs logs-app shell db reset status
+
+help:
+	@printf "%b\n" "$(GREEN)MONARC BackOffice Docker Development Environment Manager$(NC)"
+	@printf "\n%b\n" "Usage: make <command>"
+	@printf "%b\n" "Environment: ENV=<name> (default: dev, uses docker-compose.<name>.yml)"
+	@printf "\n%b\n" "Commands:"
+	@printf "  %-12s %s\n" "start" "Start all services (builds on first run)"
+	@printf "  %-12s %s\n" "stop" "Stop all services"
+	@printf "  %-12s %s\n" "restart" "Restart all services"
+	@printf "  %-12s %s\n" "logs" "View logs from all services"
+	@printf "  %-12s %s\n" "logs-app" "View logs from MONARC application"
+	@printf "  %-12s %s\n" "shell" "Open a shell in the MONARC container"
+	@printf "  %-12s %s\n" "db" "Open MySQL client in the database"
+	@printf "  %-12s %s\n" "reset" "Reset everything (removes all data)"
+	@printf "  %-12s %s\n" "status" "Show status of all services"
+
+check-env:
+	@if [ ! -f .env ]; then \
+		printf "%b\n" "$(YELLOW)No .env file found. Creating from .env.dev...$(NC)"; \
+		cp .env.dev .env; \
+		printf "%b\n" "$(GREEN).env file created. You can edit it to customize configuration.$(NC)"; \
+	fi
+
+start: check-env
+	@printf "%b\n" "$(GREEN)Starting MONARC BackOffice development environment...$(NC)"
+	@$(COMPOSE) up -d --build
+	@printf "%b\n" "$(GREEN)Services started!$(NC)"
+	@printf "%b\n" "MONARC BackOffice: http://localhost:5002"
+	@printf "\n%b\n" "$(YELLOW)To view logs: make logs ENV=$(ENV)$(NC)"
+
+stop:
+	@printf "%b\n" "$(YELLOW)Stopping all services...$(NC)"
+	@$(COMPOSE) stop
+	@printf "%b\n" "$(GREEN)Services stopped.$(NC)"
+
+restart:
+	@printf "%b\n" "$(YELLOW)Restarting all services...$(NC)"
+	@$(COMPOSE) restart
+	@printf "%b\n" "$(GREEN)Services restarted.$(NC)"
+
+logs:
+	@$(COMPOSE) logs -f
+
+logs-app:
+	@$(COMPOSE) logs -f monarc
+
+shell:
+	@printf "%b\n" "$(GREEN)Opening shell in MONARC container...$(NC)"
+	@docker exec -it monarc-bo-app bash
+
+db:
+	@printf "%b\n" "$(GREEN)Opening MySQL client...$(NC)"
+	@if [ -f .env ]; then \
+		export $$(grep -v '^#' .env | xargs); \
+	fi; \
+	export MYSQL_PWD="$${DBPASSWORD_MONARC:-sqlmonarcuser}"; \
+	docker exec -it monarc-bo-db mysql -u"$${DBUSER_MONARC:-sqlmonarcuser}" "$${DBNAME_COMMON:-monarc_common}"
+
+reset:
+	@printf "%b\n" "$(RED)WARNING: This will remove all data!$(NC)"; \
+	read -p "Are you sure? (yes/no): " confirm; \
+	if [ "$$confirm" = "yes" ]; then \
+		printf "%b\n" "$(YELLOW)Stopping and removing all containers, volumes, and data...$(NC)"; \
+		$(COMPOSE) down -v; \
+		printf "%b\n" "$(GREEN)Reset complete. Run 'make start' to start fresh.$(NC)"; \
+	else \
+		printf "%b\n" "$(GREEN)Reset cancelled.$(NC)"; \
+	fi
+
+status:
+	@$(COMPOSE) ps