netinventors/shopware repository overview

⁠Shopware 6 development image

Shopware 6 development image based on netinventors/php-base⁠. At the first start Shopware is installed automatically, including database, admin user, storefront sales channel and compiled assets.

⁠Available architectures

• amd64
• arm64

⁠Tags

Currently maintained Shopware versions are 6.6 and 6.7, each with PHP 8.2, 8.3, 8.4 and 8.5. Tags of older Shopware versions are still available, but are no longer updated.

⁠Server services

The versions below refer to the images based on netinventors/php-base 1.5.0.

• Debian Bookworm (12.15)
• Apache 2.4.68 (mpm_prefork, mod_php, modules headers, rewrite and ssl enabled)
• PHP versions (tags without -php<X.Y> suffix)
  • 7.3.33
  • 7.4.33
  • 8.0.30
  • 8.1.34
  • 8.2.35
  • 8.3.36
  • 8.4.27
  • 8.5.12
• PHP modules
  • amqp
  • apcu (Apache only)
  • curl
  • gd
  • igbinary
  • imagick
  • imap
  • intl
  • mbstring
  • mcrypt
  • memcached
  • msgpack
  • mysql (mysqli, mysqlnd, pdo_mysql)
  • opcache (Apache only)
  • redis
  • soap
  • tidy
  • xdebug (Apache only, see ENABLE_XDEBUG)
  • xml
  • zip
• AWS CLI 2.39.3
• Symfony CLI 5.22.2
• Composer 2.11.1 / 1.10.27
• Cron Daemon
• Ghostscript 10.00.0
• ImageMagick 6.9.11-60 Q16
• MariaDB 10.11.19 (starts optional)
• Redis 7.0.15 (starts optional)
• Node.js 24.22.2 (managed by n⁠ 11.0.0)
• NPM 11.19.1
• OpenSSH Server
• Supervisor Daemon 4.2.5

Shopware 6.6 and 6.7 require at least PHP 8.2.

⁠Additional packages

• bat (available as bat alias for the web user)
• default-mysql-client
• git
• iputils-ping
• joe
• jq
• less
• nano
• net-tools
• patch
• rsync
• shopware-cli 0.19.8 (shopware/shopware-cli⁠)
• shopware-patcher (netinventors/shopware6-patches⁠)
• task 3.54.0
• tidy
• unzip
• vim
• yq 4.54.1

⁠Ports

Ports that are not exposed have to be published explicitly, e.g. -p 8080:8080 -p 9998:9998 for the watchers.

The container health check requests http://127.0.0.1/ping.

⁠Customizable environment variables

All described environment variables are displayed with their default values.

⁠System

⁠Web user

The web user is created at the first container start. The user belongs to the group www-data, runs Apache, the Shopware workers and the installation, and can log in via SSH.

⁠Permission fixer

At each start the ownership and permissions of the cache, log, backup and Redis directories are fixed.

⁠PHP

The currently available PHP versions are:

• 7.3
• 7.4
• 8.0
• 8.1
• 8.2
• 8.3
• 8.4
• 8.5

The tags with a -php<X.Y> suffix only contain one PHP version, which is also the default value of PHP_VERSION.

The leading : keeps the default scan directory of the PHP version and adds the given directory.

The Apache PHP configuration contains these Shopware specific settings:

⁠Composer

Both versions are available as composer-1 and composer-2, composer links to the selected one.

⁠Node.js / NPM and Node.js module n

If NODE_VERSION or NPM_VERSION differs from the preinstalled version, the requested version is installed at container start (internet access required). NODE_VERSION accepts every version n understands, e.g. 22 or lts. The value -1 skips the installation.

⁠Shopware

SHOPWARE_FORCE_INSTALL="true" drops the database and overwrites the files in /var/www/html at every start. The installation runs at container start. Meanwhile a preview page is shown on port 80 and 443.

⁠MySQL database server

If MYSQL_HOST is localhost or 127.0.0.1 a local MariaDB server instance will be started automatically and the user and database are created during the installation. For an external server the user must already exist.

⁠Redis server

If ENABLE_REDIS is "true", the Redis configurations of Shopware are enabled (cache, session, lock, cart, number range, increment and message queue). If REDIS_HOST is localhost or 127.0.0.1 a local Redis server is started as well. With ENABLE_REDIS set to "false" the Redis configurations are disabled during the installation.

The local Redis server is configured with REDIS_PORT and REDIS_PASSWORD at every container start.

⁠Installation hooks

The installation runs the following steps. For each step a Taskfile⁠ with a execute task can be placed in /docker-entrypoint-install.d as pre-<step>.yml or post-<step>.yml, e.g. post-install-shopware.yml. Taskfiles run as web user.

Example of a plugins.json, the keys are the plugin names, the values the Composer requirements:

{
  "plugins": {
    "FroshTools": "frosh/tools:^3.0",
    "FroshPlatformMailArchive": "frosh/mail-platform-archive"
  }
}

The installation can be repeated manually with install-shopware.sh -f as root.

⁠Background processes

Supervisor runs the following processes:

• Apache
• Cron
• SSH server
• MariaDB (only with local MYSQL_HOST)
• Redis (only with ENABLE_REDIS="true" and local REDIS_HOST)
• Shopware message queue consumers (async and failed)
• Shopware scheduled tasks

The logs of the Shopware processes are written to /usr/local/var/log/shopware.

⁠Shopware package configurations

Additional Symfony package configurations are stored in config/packages/shopware-available/<min-shopware-version> and are enabled with symbolic links in config/packages/shopware-enabled. Only configurations for the installed Shopware version are enabled. All of them are enabled during the installation.

Use task config:enable and task config:disable to switch them, e.g. task config:disable -- "redis*".

⁠Directories

The log directory contains the logs of Apache, MariaDB, Redis, Shopware and supervisor and is linked as ~/log into the home directory of the web user.

⁠Breaking changes

Some mapped volumes will now locate in different places.

⁠Taskfile

You can run different commands directly via task⁠ in /var/www/html. Executing task without an argument is an alias for task --list and shows the available commands.

The *:build:full commands are also available as *:build:all.

⁠Available commands