Docker windows

Keep the installation documentation in mind, as You will there the descriptions of most important steps. Current step consist only of information regarding running the project via Docker on Windows.

Steps by step guide

info

The steps provided by @rwaight have been tested using Docker on Windows 10 (using the WSL 2 based engine). Everything was then retested with Hyper-V mode docker.

  1. Download the latest PMS version
  2. Extract/unzip the entire project into a folder on your system (example: C:\docker\pms)
  3. In PowerShell, navigate to the project directory
    • type cd C:\docker\pms\
info

Command prompt should show PS C:\docker\pms

  1. Build the containers (while staying in C:\docker\pms), by calling given commands
    • docker-compose build
    • docker-compose up -d
  2. Enter the php-fpm container and continue installation, by calling docker-compose exec php-fpm bash
info

Command prompt should change to the container: root@<container_id>:/application

Example: root@682bdf287a87:/application

  1. Install apcu and update php configuration
  • Install apcu with pecl install apcu
info

Output should be similar to:

'install ok: channel://pecl.php.net/apcu-5.1.19'
'Extension apcu enabled in php.ini'
  • Update php configuration with pear config-set php_ini /application/docker/php-fpm/php.ini
info

Output should be similar to:

'config-set succeeded'
  1. Continue with installation of Composer and pms-installer-docker
  • call composer install
info

You should see this complete after installing approximately 140+ packages Look for:

'Use the `composer fund` command to find out more!'
'Run composer recipes at any time to see the status of your Symfony recipes.'
  • call composer pms-installer-docker
info

You should see this complete with output providing next steps, including:

'User register:'
'Simply open the project in browser and if no user is registered, then You will see register button'
warning

The docker on Windows might be very slow, glitchy and looks like it's frozen during the installation. That can be normal depending on the docker app/Windows configuration. Upon suspecting shell being frozen - hit spacebar or arrow down to refresh the screen, however do not hit Enter as it might start installation anew.

  1. Exit the php-fpm container, then restart the docker containers using the container IDs
  • call exit then the command prompt should switch back to PS C:\docker\pms
  • Find the container IDs using `docker ps*
    CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
    a719234ab9a1 pms-1430-attempt04_php-fpm "docker-php-entrypoi…" 31 minutes ago Up 31 minutes 9000/tcp php-fpm
    113bfc52caf2 mariadb "docker-entrypoint.s…" 31 minutes ago Up 31 minutes 3306/tcp mariadb
    0b16cdd476b5 nginx:alpine "/docker-entrypoint.…" 31 minutes ago Up 31 minutes 0.0.0.0:8001->80/tcp nginx
    bd29ef0790c4 adminer "entrypoint.sh docke…" 31 minutes ago Up 31 minutes 0.0.0.0:8081->8080/tcp adminer
  • Restart the containers with docker container restart <container1id> <container2id> <container3id> <container4id> (or restart whole project in docker GUI)
  • Once the containers have restarted, browse to http://127.0.0.1:8001 and begin using Personal Management System