What problem does it solve? Setting up OrangeHRM locally requires a separate Docker companion repo, multiple PHP/DB containers, host port management, and hostname routing — this Skill provides the reference for running, switching, and debugging that environment without installing PHP or MySQL on the host. ## Core Features & Use Cases - Container orchestration guidance: Documents the orangehrm-os-dev-environment repo layout, available PHP (5.6–8.3) and MySQL/MariaDB services, container naming, and common docker compose commands. - Version selection rule: Directs developers to derive the lowest supported PHP version from src/composer.json before installing dependencies, and to run Composer/Yarn inside the PHP container. - Troubleshooting playbook: Maps symptoms (port 80/443 conflicts, "database connection refused", unreachable http://phpXX/, mount issues) to diagnostic commands and fixes. - Use Case: A developer hits "port is already allocated" when starting the stack — the Skill walks through checking which process holds port 80, then either freeing it or remapping host ports in the companion repo's .env. ## Quick Start Ask the agent to help you start the OrangeHRM Docker dev environment with the lowest supported PHP version and a MariaDB container.
