agencetca / docker-magento2

A base Magento 2 image that can be used to scale in production

docker-magento2

A base Magento 2 image that can be used to scale in production. This can be used in combination with MySQL and Redis. It is opinionated and includes support for Composer, ionCube, Redis, OPcache, and the required PHP modules for a basic Magento installation.

It does not include Magento.

Usage

An example Dockerfile

FROM sensson/magento2
COPY src/ /var/www/html/

More details can be found in Magento2 and Docker.

Persistent storage

The container assumes you do not store data in a folder along with the application. Don't use Docker volumes for scale. Use CephFS, GlusterFS or integrate with S3 or S3-compatible services such as Fuga.io.

Configuration

Environment variables

Environment variable	Description	Default
MYSQL_HOSTNAME	MySQL hostname	mysql
MYSQL_USERNAME	MySQL username	root
MYSQL_PASSWORD	MySQL password	secure
MYSQL_DATABASE	MySQL database	magento
CRYPTO_KEY	Magento Encryption key	Emtpy
URI	Uri (e.g. http://localhost)	http://localhost
RUNTYPE	Set to development to enable	Empty
ADMIN_USERNAME	Administrator username	admin
ADMIN_PASSWORD	Administrator password	adm1nistrator
ADMIN_FIRSTNAME	Administrator first name	admin
ADMIN_LASTNAME	Administrator last name	admin
ADMIN_EMAIL	Administrator email address	[email protected]
BACKEND_FRONTNAME	The URI of the admin panel	admin
CURRENCY	Magento's default currency	EUR
LANGUAGE	Magento's default language	en_US
CONTENT_LANGUAGES	The languages used in Magento	en_US
TIMEZONE	Magento's timezone	Europe/Amsterdam
CRON	Run as a cron container	false
UNATTENDED	Run unattended upgrades	false

Include the port mapping in URI if you run your shop on a local development environment, e.g. http://localhost:3000/.

Hooks

Hooks allow you to run certain actions at certain points in the startup procedure without having to rewrite entrypoint.sh. You can use hooks to import data, preconfigure settings or run other scripts that need to run each startup sequence.

Hook point	Location	Description
Pre install	/hooks/pre_install.sh	Runs before an installation or update.
Pre compile	/hooks/pre_compile.sh	Runs before code compilation starts.
Post install	/hooks/post_install.sh	Runs after Magento has been installed.

You need to COPY any hooks to this location yourself.

Development mode

Setting RUNTYPE to development will turn on public error reports. Anything else will leave it off. It will also set display_errors to on in PHP. This is set to off by default.

A basic docker-compose.yml has been provided to help during the development of this image.