Dockware

Dockware is basically a managed docker setup for Shopware 6. It makes it possible to start Shopware 6 in just a couple of seconds using dockware.io. It already comes with everything you need for a smooth development workflow. This includes all available Shopware 6 versions, MySQL, Adminer, Mailcatcher, easy PHP switching, XDebug, useful make commands and way more.
Dockware is maintained by dasistweb GmbH. They provide a detailed documentation as well. This way, we'll cover just the basics here - For details please feel free to refer to the original dockware docs at any time.
Dockware versions
Dockware images come in several version so you can choose the one which fits your needs best. You can find a brief overview below, but as always, please refer to their website for a detailed comparison.
Image
Description
Basis
dockware #play
Launch Shopware in just a couple of seconds locally on your system. Test every functionality and play around while verifying your requirements.
Production
dockware #dev
This is the solution for instant coding. Run Shopware 6, prepare your IDE and immediately start with your own customizations and plugins. Provides Xdebug, watchers or more.
Production
dockware #contribute
This image supports Shopware 6 modification, basically to contribute to the official Shopware 6 Github platform. Contains all dev tools and the already installed demo data.
developement
dockware #essentials
This is a plain dockware environment without Shopware.
---
dockware #flex
This one provides a flexible Apache and PHP container for all kinds of Symfony and Shopware projects. It's an image meant for for individualization, e.g. you can manage the Shopware version on your own.
---
Quickstart
First things first, please install Docker on your local maschine.
If using Linux, you need to start by downloading the latest version of Docker and install it on your system. To
name a few examples, you can find the matching docker versions for your distribution here:
​Docker for Ubuntu​
​Docker for Debian​
​Docker for CentOS​
​Docker for Fedora​
For Windows operating system. please download the latest version of Docker desktop for Windows.
If using Mac, please start by downloading the latest version of
​Docker Desktop for Mac and install it.
Afterwards, you are almost ready to start. You just need to use the following command on your host system to get it going:
1
# quick run with latest PHP and Shopware
2
$ docker run --rm -p 80:80 dockware/dev:latest
Copied!
Beware that this is meant for quickstart. The parameter --rm will throw everything away. If the container is stopped the whole database etc. will be gone. So if you want a persistent solution, head over to the "Using docker-compose" paragraph.
This command will install Dockware #dev version, which is based on Production template. If you want to use development template, you need to use #contribute version. As soon as the docker image is downloaded and dockware is ready, you will see this text:
1
SUCCESS - Shopware is now ready!
2
-----------------------------------------------------
3
SHOP URL: http://localhost
4
ADMIN URL: http://localhost/admin
5
ADMINER URL: http://localhost/adminer.php
6
MAILCATCHER URL: http://localhost/mailcatcher
Copied!
Further ways to start
You can start the dockware image with different shopware versions:
1
docker run --rm -p 80:80 --env PHP_VERSION=7.2 dockware/dev:latest
Copied!
Using docker-compose
Create docker-compose.yml
Create a new docker-compose.yml in the folder where you want to start your project and use our template below.
Dockware does already come with an installed Shopware 6. You can change the Shopware version along with the PHP version in your compose file.
Here's an overview about what versions are available: https://hub.docker.com/r/dockware/dev​
1
version: "3"
2
​
3
services:
4
​
5
    shopware:
6
      # use either tag "latest" or any other version like "6.1.5", ...
7
      image: dockware/dev:latest
8
      container_name: shopware
9
      ports:
10
         - "80:80"
11
         - "3306:3306"
12
         - "22:22"
13
         - "8888:8888"
14
         - "9999:9999"
15
      volumes:
16
         - "db_volume:/var/lib/mysql"
17
         - "shop_volume:/var/www/html"
18
      networks:
19
         - web
20
      environment:
21
         # default = 0, recommended to be OFF for frontend devs
22
         - XDEBUG_ENABLED=1
23
         # default = latest PHP, optional = specific version
24
         - PHP_VERSION=7.4
25
​
26
volumes:
27
  db_volume:
28
    driver: local
29
  shop_volume:
30
    driver: local
31
​
32
networks:
33
  web:
34
    external: false
Copied!
Start Docker
Open the folder with your compose file in your terminal and execute this command to start your container:
1
docker-compose up -d
Copied!
Prepare Development
Now download the current version of Shopware to your host into a "src" directory.
This is required to have code completion and IntelliSense right in your IDE.
1
mkdir -p ./src
2
docker cp shopware:/var/www/html/. ./src
Copied!
Prepare IDE
Open the "src" folder with your preferred IDE and wait until finished loading. Then add a new SFTP connection to your container. (We recommend Automatic-Upload if possible)
That's it, you're done and ready to develop your own plugins and projects.
Default credentials for dockware can be found at https://docs.dockware.io/use-dockware/default-credentials​
Next steps
Would you like to explore alternative ways to install Shopware? You can install Shopware on Mac with the help of other tools:
​Docker​
​Vagrant​
​MAMP​
Otherwise, you might want to start writing your very own plugin. Head over to Plugin base guide to get a grip on that topic.
Here's a video explaining the basics of Dockware from our free online training "Backend Development".
​Using Dockware​
Installation overview
Docker
Last modified 3mo ago
Copy link
Edit on GitHub
Contents
Dockware versions
Quickstart
Further ways to start
Using docker-compose
Next steps