Docker Dev Environment

Warning

The provided docker configuration should not be used in production environments!

Installation on your local machine

• Install Docker and Docker Compose
• Create a new folder and clone the repository
• Start containers with CURRENT_UID=$(id -u):$(id -g) docker compose up -d
• When all containers are up and running, run: bash ./devtools/init-dev-setup.sh
• Open http://localhost:8001 to get to the homepage
• Open http://localhost:8080 to get to phpmyadmin of database-dev

If you add 127.0.0.1 foodcoopshop.test to your hosts file, you can use http://foodcoopshop.test:8001. Do not forget to change App.fullBaseUrl to http://foodcoopshop.test:8001.

Installation on Gitpod

• When all containers are up and running (takes between 1 and 2 minutes), open your Bash-terminal (not the Docker-terminal) and run bash ./devtools/init-dev-setup.sh
• In your custom_config.php, change App.fullBaseUrl to your custom Gitpod-Domain (starting with https://8001-foodcoopsho-foodcoopsho... Be careful, the domain must not end with a slash!).

Login credentials

• The available demo test data is in German.
• You can chose between 4 different users to login on http://localhost:8001/anmelden
• Superadmin: fcs-demo-superadmin@mailinator.com / Password: foodcoopshop
• Admin: fcs-demo-admin@mailinator.com / Password: foodcoopshop
• Member: fcs-demo-mitglied@mailinator.com / Password: foodcoopshop
• Manufacturer: fcs-demo-fleisch-hersteller@mailinator.com / Password: foodcoopshop

Unit Tests

• docker exec -w /app fcs.php php ./vendor/bin/phpunit
• Open http://localhost:8081 to get to phpmyadmin of database-test
• On my local machine the current 546 tests finish in around 1:40 min, On Github Actions they need around 4:30 min.

Tools

• Run composer: docker exec -w /app fcs.php composer install|update|outdated
• Run npm-check-updates: docker exec -w /app/webroot fcs.php ncu
• Run npm: docker exec -w /app/webroot fcs.php npm install
• Update po-Files (translations): docker exec -w /app fcs.php bash ./devtools/update-translations.sh
• Running migrations: docker exec -w /app fcs.php bash ./bin/cake migrations migrate
• Build assets: docker exec -w /app fcs.php bash ./bin/cake asset_compress build

Tips for using Docker on Windows

• Install Ubuntu and switch to WSL2
• Docker Desktop: Settings / Resources / WSL Integration: Enable integration with additional distros: Enable “Ubuntu”
• Clone the repo and start docker from Ubuntu (1.000 times faster than if you start it in Windows)