docker setup by netshops

This docker setup was intended to be used with Shopware but as it is that generic you could run almost every PHP based web application that needs a webserver and database.

Feel free to contribute. Join the discussion on Skype.

Important information: This setup is for local programing purposes only!

Installation instructions

Getting started

1. Set a host entry in your local hosts file to 127.0.0.1 dev.local
2. Navigate to your projects root
3. Execute git clone https://github.com/Netshops-Commerce-GmbH/docker-setup.git
4. Navigate to the created folder with cd docker-setup/
5. Adjust the shopware release url in docker-compose.yml
6. Execute docker-compose pull to get the newest images
7. Change FULL_WIPE_ON_REBOOT in docker-compose.yml to "false" if you dont need the installation wizard.
8. Change the environment variable COMPOSE_PROJECT_NAME=project in .env
9. Execute docker-compose up
10. If needed run your setup and change FULL_WIPE_ON_REBOOT in docker-compose.yml to "true" afterwards. Alternatively you can just import an SQL dump.
11. Open http://dev.local/ in your browser.

Database credentials

  Host: db
  User: root
  Password: root
  Database: dev

Configuring Mailhog

1. Navigate to the Shopware backend
2. Open the Global Settings and search for "Mailer"
3. Apply the following settings:
   • Method: smtp
   • Hostname for message id: mailhog.dev.local
   • Mail hostname: mailfetcher
   • Port: 1025
   • Prefix:
   • SMTP user: test
   • SMTP password: test
   • Connection auth: login
4. Open the mailhog webinterface
5. Send a mail from the Shopware backend (Settings -> Email Templates -> Choose a template -> Send test email to shop owner)

Docker structure

Image layers

• datacontainer
  • Image: netshops/dev_data_container_shopware:latest
  • Description: This container holds a fresh installation of Shopware and extracts it on every "up".
• datasync
  • Image: netshops/dev_data_sync:latest
  • Description: This container syncs /var/www/src into /var/www/html on "up" and after that constatly with inotify on file changes.
• webserver
  • Image: nginx:stable
  • Description: Webserver to serve contents. Can be nginx or apache. Just configure it to your needs.
• phpfpm
  • Image: netshops/dev_php_fpm_ioncube
  • Description: PHP 7.0 with IonCube Loader and Xdebug
• db
  • Image: percona:latest (MySQL Fork)
  • Description: A MySQL container. Choose whatever you like (e.g. MySQL, MariaDB, Percona)
• mailfetcher
  • Image: mailhog/mailhog:latest
  • Description: A mail fetcher. Can be opened under http://dev.local:8025/

Directory structure

• projectname/
  • docker-setup/
    • services/ (config files mounted as volumes)
      • nginx
      • percona
      • phpfpm
    • src/
      • config_dev.php (copy to ../../src/)
  • src/ (changed files that are synced into a fresh shop-installation)
    • custom/plugins/.../
    • engine/Shopware/Plugins/.../
    • themes/Frontend/YourThemeName/

Licence

This project uses the GNU General Public License v3.0.